Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion common/config/rush/pnpm-lock.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

235 changes: 227 additions & 8 deletions sdk/migrate/arm-migrate/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,234 @@
# Release History

## 2.0.4 (Unreleased)


## 3.0.0-beta.1 (2025-05-13)
Compared with version 2.0.3

### Features Added

### Breaking Changes
- Added operation group AvsAssessedMachinesV2OperationsOperations
- Added operation group AvsAssessmentsV2OperationsOperations
- Added operation group AvsAssessmentV2SummaryOperationsOperations
- Added operation group AvsGraphAssessmentOptionsOperationsOperations
- Added Interface AssessmentDetails
- Added Interface AvsAssessedDiskV2
- Added Interface AvsAssessedMachineExtendedDetails
- Added Interface AvsAssessedMachinePropertiesV2
- Added Interface AvsAssessedMachinesV2OperationsGetOptionalParams
- Added Interface AvsAssessedMachinesV2OperationsListByParentOptionalParams
- Added Interface AvsAssessedMachineV2
- Added Interface AvsAssessedNetworkAdapter
- Added Interface AvsAssessmentOptionsOutboundEdgeGroup
- Added Interface AvsAssessmentPropertiesV2
- Added Interface AvsAssessmentSettings
- Added Interface AvsAssessmentSummaryPropertiesV2
- Added Interface AvsAssessmentsV2OperationsCreateOptionalParams
- Added Interface AvsAssessmentsV2OperationsDeleteOptionalParams
- Added Interface AvsAssessmentsV2OperationsDownloadUrlOptionalParams
- Added Interface AvsAssessmentsV2OperationsGetOptionalParams
- Added Interface AvsAssessmentsV2OperationsListByParentOptionalParams
- Added Interface AvsAssessmentV2
- Added Interface AvsAssessmentV2Summary
- Added Interface AvsAssessmentV2SummaryOperationsGetOptionalParams
- Added Interface AvsAssessmentV2SummaryOperationsListByParentOptionalParams
- Added Interface AvsEstimatedExternalStorage
- Added Interface AvsEstimatedNetwork
- Added Interface AvsEstimatedNode
- Added Interface AvsGraphAssessmentOptions
- Added Interface AvsGraphAssessmentOptionsOperationsGetOptionalParams
- Added Interface AvsGraphAssessmentOptionsOperationsListByParentOptionalParams
- Added Interface AvsGraphAssessmentOptionsProperties
- Added Interface AvsRecommendationsMigrationIssuesMigrationSuitabilitySkus
- Added Interface BillingSettings
- Added Interface Configuration
- Added Interface CostDetailsCommon
- Added Interface ErrorAdditionalInfo
- Added Interface ErrorDetail
- Added Interface ErrorModel
- Added Interface ErrorResponse
- Added Interface Linkages
- Added Interface ManagementDetails
- Added Interface MigrateClientOptionalParams
- Added Interface MigrationDetails
- Added Interface MigrationIssues
- Added Interface MigrationSuitability
- Added Interface MoreInformation
- Added Interface NameValuePair
- Added Interface NameValuePairCloudSuitabilityCommon
- Added Interface NameValuePairCostType
- Added Interface NameValuePairSavingsType
- Added Interface PagedAsyncIterableIterator
- Added Interface PageSettings
- Added Interface PerformanceData
- Added Interface ProxyResource
- Added Interface RecommendedFor
- Added Interface Resource
- Added Interface RestorePollerOptions
- Added Interface SavingsDetailsCommon
- Added Interface SavingsSettings
- Added Interface Scope
- Added Interface SecuritySuitability
- Added Interface SkuDetails
- Added Interface SkusMigrationSuitability
- Added Interface SourceDetails
- Added Interface SourceRecommendationMigrationSuitability
- Added Interface SystemData
- Added Interface TargetDetails
- Added Interface TargetSourcePair
- Added Class MigrateClient
- Added Type Alias ActionType
- Added Type Alias AssessedMachineType
- Added Type Alias AssessmentSource
- Added Type Alias AvsAssessmentScenario
- Added Type Alias AzureAvsNodeType
- Added Type Alias AzureAvsSuitabilityExplanation
- Added Type Alias AzureCurrency
- Added Type Alias AzureManagementOfferingType
- Added Type Alias AzureOffer
- Added Type Alias AzureReservedInstance
- Added Type Alias AzureTarget
- Added Type Alias CloudSuitabilityCommon
- Added Type Alias ContinuablePage
- Added Type Alias CostType
- Added Type Alias CreatedByType
- Added Type Alias EnvironmentType
- Added Type Alias ExternalStorageType
- Added Type Alias FttAndRaidLevel
- Added Type Alias GuestOperatingSystemArchitecture
- Added Type Alias LicensingProgram
- Added Type Alias LinkageKind
- Added Type Alias LinkageType
- Added Type Alias MigrateWorkloadType
- Added Type Alias MigrationIssuesCategory
- Added Type Alias MigrationPlatform
- Added Type Alias MigrationType
- Added Type Alias NetworkSkuType
- Added Type Alias Origin
- Added Type Alias SavingsOptions
- Added Type Alias SavingsType
- Added Type Alias ScopeType
- Added Type Alias SkuKind
- Added Type Alias SkuType
- Added Type Alias StrategyType
- Added Type Alias SummaryType
- Interface Operation has a new optional parameter actionType
- Interface Operation has a new optional parameter isDataAction
- Added Enum KnownActionType
- Added Enum KnownAssessedMachineType
- Added Enum KnownAssessmentSource
- Added Enum KnownAvsApiVersions
- Added Enum KnownAvsAssessmentScenario
- Added Enum KnownAzureAvsNodeType
- Added Enum KnownAzureAvsSuitabilityExplanation
- Added Enum KnownAzureCurrency
- Added Enum KnownAzureManagementOfferingType
- Added Enum KnownAzureOffer
- Added Enum KnownAzureReservedInstance
- Added Enum KnownAzureTarget
- Added Enum KnownCloudSuitabilityCommon
- Added Enum KnownCostType
- Added Enum KnownCreatedByType
- Added Enum KnownEnvironmentType
- Added Enum KnownExternalStorageType
- Added Enum KnownFttAndRaidLevel
- Added Enum KnownGuestOperatingSystemArchitecture
- Added Enum KnownLicensingProgram
- Added Enum KnownLinkageKind
- Added Enum KnownLinkageType
- Added Enum KnownMigrateWorkloadType
- Added Enum KnownMigrationIssuesCategory
- Added Enum KnownMigrationPlatform
- Added Enum KnownMigrationType
- Added Enum KnownNetworkSkuType
- Added Enum KnownOrigin
- Added Enum KnownSavingsOptions
- Added Enum KnownSavingsType
- Added Enum KnownScopeType
- Added Enum KnownSkuKind
- Added Enum KnownSkuType
- Added Enum KnownStrategyType
- Added Enum KnownSummaryType
- Enum KnownAssessmentStatus has a new value Deleted
- Enum KnownAssessmentStatus has a new value Failed
- Enum KnownAzureLocation has a new value AustraliaCentral
- Enum KnownAzureLocation has a new value AustraliaCentral2
- Enum KnownAzureLocation has a new value ChinaEast2
- Enum KnownAzureLocation has a new value ChinaNorth2
- Enum KnownAzureLocation has a new value FranceCentral
- Enum KnownAzureLocation has a new value FranceSouth
- Enum KnownAzureLocation has a new value GermanyNorth
- Enum KnownAzureLocation has a new value GermanyWestCentral
- Enum KnownAzureLocation has a new value IsraelCentral
- Enum KnownAzureLocation has a new value ItalyNorth
- Enum KnownAzureLocation has a new value JioIndiaWest
- Enum KnownAzureLocation has a new value MexicoCentral
- Enum KnownAzureLocation has a new value NewZealandNorth
- Enum KnownAzureLocation has a new value NorwayEast
- Enum KnownAzureLocation has a new value NorwayWest
- Enum KnownAzureLocation has a new value PolandCentral
- Enum KnownAzureLocation has a new value QatarCentral
- Enum KnownAzureLocation has a new value SouthAfricaNorth
- Enum KnownAzureLocation has a new value SouthAfricaWest
- Enum KnownAzureLocation has a new value SpainCentral
- Enum KnownAzureLocation has a new value SwedenCentral
- Enum KnownAzureLocation has a new value SwitzerlandNorth
- Enum KnownAzureLocation has a new value SwitzerlandWest
- Enum KnownAzureLocation has a new value UAECentral
- Enum KnownAzureLocation has a new value UAENorth
- Enum KnownAzureLocation has a new value UsNatEast
- Enum KnownAzureLocation has a new value UsNatWest
- Enum KnownAzureLocation has a new value UsSecCentral
- Enum KnownAzureLocation has a new value UsSecEast
- Enum KnownAzureLocation has a new value UsSecWest
- Enum KnownMachineBootType has a new value NotSpecified
- Enum KnownPercentile has a new value PercentileUnknown
- Enum KnownProvisioningState has a new value Canceled
- Enum KnownProvisioningState has a new value Provisioning
- Enum KnownProvisioningState has a new value Updating
- Added function restorePoller

### Bugs Fixed

### Other Changes
### Breaking Changes

- Removed operation group AssessedMachines
- Removed operation group Assessments
- Removed operation group Groups
- Removed operation group HyperVCollectors
- Removed operation group ImportCollectors
- Removed operation group Machines
- Removed operation group PrivateEndpointConnectionOperations
- Removed operation group PrivateLinkResourceOperations
- Removed operation group Projects
- Removed operation group ServerCollectors
- Removed operation group VMwareCollectors
- Deleted Class AzureMigrateV2
- Parameter assessmentReportUrl of interface DownloadUrl is now required
- Parameter expirationTime of interface DownloadUrl is now required
- Type of parameter origin of interface Operation is changed from string to Origin
- Removed Enum KnownAssessmentStage
- Removed Enum KnownAzureDiskSize
- Removed Enum KnownAzureDiskSuitabilityDetail
- Removed Enum KnownAzureDiskSuitabilityExplanation
- Removed Enum KnownAzureDiskType
- Removed Enum KnownAzureHybridUseBenefit
- Removed Enum KnownAzureNetworkAdapterSuitabilityDetail
- Removed Enum KnownAzureNetworkAdapterSuitabilityExplanation
- Removed Enum KnownAzureOfferCode
- Removed Enum KnownAzurePricingTier
- Removed Enum KnownAzureStorageRedundancy
- Removed Enum KnownAzureVmFamily
- Removed Enum KnownAzureVmSize
- Removed Enum KnownAzureVmSuitabilityDetail
- Removed Enum KnownAzureVmSuitabilityExplanation
- Removed Enum KnownCurrency
- Removed Enum KnownGroupStatus
- Removed Enum KnownGroupUpdateOperation
- Removed Enum KnownPrivateEndpointConnectionPropertiesProvisioningState
- Removed Enum KnownPrivateLinkServiceConnectionStateStatus
- Removed Enum KnownProjectStatus
- Removed Enum KnownReservedInstance
- Enum KnownProvisioningState no longer has value Creating
- Enum KnownProvisioningState no longer has value Moving
- Removed function getContinuationToken

## 2.0.3 (2023-01-29)

### Features Added
Expand Down Expand Up @@ -40,4 +259,4 @@ To understand the detail of the change, please refer to [Changelog](https://aka.

To migrate the existing applications to the latest version, please refer to [Migration Guide](https://aka.ms/js-track2-migration-guide).

To learn more, please refer to our documentation [Quick Start](https://aka.ms/azsdk/js/mgmt/quickstart ).
To learn more, please refer to our documentation [Quick Start](https://aka.ms/azsdk/js/mgmt/quickstart).
2 changes: 1 addition & 1 deletion sdk/migrate/arm-migrate/LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
SOFTWARE.
50 changes: 24 additions & 26 deletions sdk/migrate/arm-migrate/README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
# AzureMigrateV2 client library for JavaScript
# Azure Migrate client library for JavaScript

This package contains an isomorphic SDK (runs both in Node.js and in browsers) for AzureMigrateV2 client.
This package contains an isomorphic SDK (runs both in Node.js and in browsers) for Azure Migrate client.

Assess your workloads for Azure.
Azure Migrate Resource Provider management API.

[Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/migrate/arm-migrate) |
[Package (NPM)](https://www.npmjs.com/package/@azure/arm-migrate) |
[API reference documentation](https://learn.microsoft.com/javascript/api/@azure/arm-migrate) |
[Samples](https://github.com/Azure-Samples/azure-samples-js-management)
Key links:

- [Source code](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/migrate/arm-migrate)
- [Package (NPM)](https://www.npmjs.com/package/@azure/arm-migrate)
- [API reference documentation](https://learn.microsoft.com/javascript/api/@azure/arm-migrate?view=azure-node-preview)
- [Samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/migrate/arm-migrate/samples)

## Getting started

Expand All @@ -24,16 +26,16 @@ See our [support policy](https://github.com/Azure/azure-sdk-for-js/blob/main/SUP

### Install the `@azure/arm-migrate` package

Install the AzureMigrateV2 client library for JavaScript with `npm`:
Install the Azure Migrate client library for JavaScript with `npm`:

```bash
npm install @azure/arm-migrate
```

### Create and authenticate a `AzureMigrateV2`
### Create and authenticate a `MigrateClient`

To create a client object to access the AzureMigrateV2 API, you will need the `endpoint` of your AzureMigrateV2 resource and a `credential`. The AzureMigrateV2 client can use Azure Active Directory credentials to authenticate.
You can find the endpoint for your AzureMigrateV2 resource in the [Azure Portal][azure_portal].
To create a client object to access the Azure Migrate API, you will need the `endpoint` of your Azure Migrate resource and a `credential`. The Azure Migrate client can use Azure Active Directory credentials to authenticate.
You can find the endpoint for your Azure Migrate resource in the [Azure Portal][azure_portal].

You can authenticate with Azure Active Directory using a credential from the [@azure/identity][azure_identity] library or [an existing AAD Token](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-with-a-pre-fetched-access-token).

Expand All @@ -43,44 +45,42 @@ To use the [DefaultAzureCredential][defaultazurecredential] provider shown below
npm install @azure/identity
```

You will also need to **register a new AAD application and grant access to AzureMigrateV2** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).
Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`.
You will also need to **register a new AAD application and grant access to Azure Migrate** by assigning the suitable role to your service principal (note: roles such as `"Owner"` will not grant the necessary permissions).

For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).

Using Node.js and Node-like environments, you can use the `DefaultAzureCredential` class to authenticate the client.

```ts snippet:ReadmeSampleCreateClient_Node
import { AzureMigrateV2 } from "@azure/arm-migrate";
import { MigrateClient } from "@azure/arm-migrate";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AzureMigrateV2(new DefaultAzureCredential(), subscriptionId);
const client = new MigrateClient(new DefaultAzureCredential(), subscriptionId);
```

For browser environments, use the `InteractiveBrowserCredential` from the `@azure/identity` package to authenticate.

```ts snippet:ReadmeSampleCreateClient_Browser
import { InteractiveBrowserCredential } from "@azure/identity";
import { AzureMigrateV2 } from "@azure/arm-migrate";
import { MigrateClient } from "@azure/arm-migrate";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const client = new AzureMigrateV2(credential, subscriptionId);
clientId: "<YOUR_CLIENT_ID>"
});
const client = new MigrateClient(credential, subscriptionId);
```

### JavaScript Bundle

### JavaScript Bundle
To use this client library in the browser, first you need to use a bundler. For details on how to do this, please refer to our [bundling documentation](https://aka.ms/AzureSDKBundling).

## Key concepts

### AzureMigrateV2
### MigrateClient

`AzureMigrateV2` is the primary interface for developers using the AzureMigrateV2 client library. Explore the methods on this client object to understand the different features of the AzureMigrateV2 service that you can access.
`MigrateClient` is the primary interface for developers using the Azure Migrate client library. Explore the methods on this client object to understand the different features of the Azure Migrate service that you can access.

## Troubleshooting

Expand All @@ -98,7 +98,7 @@ For more detailed instructions on how to enable logs, you can look at the [@azur

## Next steps

Please take a look at the [samples](https://github.com/Azure-Samples/azure-samples-js-management) directory for detailed examples on how to use this library.
Please take a look at the [samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/migrate/arm-migrate/samples) directory for detailed examples on how to use this library.

## Contributing

Expand All @@ -108,8 +108,6 @@ If you'd like to contribute to this library, please read the [contributing guide

- [Microsoft Azure SDK for JavaScript](https://github.com/Azure/azure-sdk-for-js)

[azure_cli]: https://learn.microsoft.com/cli/azure
[azure_sub]: https://azure.microsoft.com/free/
[azure_sub]: https://azure.microsoft.com/free/
[azure_portal]: https://portal.azure.com
[azure_identity]: https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity
Expand Down
8 changes: 0 additions & 8 deletions sdk/migrate/arm-migrate/_meta.json

This file was deleted.

Loading