Skip to content

Commit 4e30033

Browse files
Fix acrolinx issues
1 parent fceb92f commit 4e30033

1 file changed

Lines changed: 28 additions & 28 deletions

File tree

articles/migrate/how-to-automate-vmware-to-azure-migration-rest-api.md

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Before you begin, make sure you have the following:
3636

3737
Before you call the APIs, gather the required resource identifiers. This section describes how to obtain each identifier.
3838

39-
### Get the Azure Site Recovery Vault Id
39+
### Get the Azure Site Recovery Vault ID
4040

4141
In the Azure portal, go to your **Azure Migrate project > Execute > Migrations > Replications summary > Properties**.
4242
Under Linked Recovery Services vaults, identify the vault where Replication type is set to Other, and copy the Vault ID.
@@ -46,7 +46,7 @@ The resource ID format is:
4646
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{migrateProjectName-MigrateVault-numbers}
4747
```
4848

49-
### Get the Process server Id and Site Ids
49+
### Get the Process server ID and Site IDs
5050

5151
The `processServerId` is the machine ID of the replication appliance that handles VM replication. To retrieve it:
5252

@@ -111,7 +111,7 @@ Use the `id` value from the process server entry as your `processServerId` that
111111

112112
### Get the Fabric Discovery Machine ID
113113

114-
The `fabricDiscoveryMachineId` is the ARM ID of the discovered VM from Azure Migrate. To find it:
114+
The `fabricDiscoveryMachineId` is the Azure Resource Manager ID of the discovered VM from Azure Migrate. To find it:
115115

116116
```http
117117
(for VMware VMs) GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/VMwareSites/{siteName}/machines?api-version=2023-06-06
@@ -208,25 +208,25 @@ PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{
208208
| Parameter | Required | Description |
209209
|-----------|----------|-------------|
210210
| `instanceType` | Yes | Must be `InMageRcm` |
211-
| `fabricDiscoveryMachineId` | Yes | ARM ID of the discovered VMware machine from Azure Migrate |
211+
| `fabricDiscoveryMachineId` | Yes | Azure Resource Manager ID of the discovered VMware machine from Azure Migrate |
212212
| `processServerId` | Yes | ID of the process server to use for replication |
213-
| `targetResourceGroupId` | Yes | ARM ID of the target resource group in Azure |
213+
| `targetResourceGroupId` | Yes | Azure Resource Manager ID of the target resource group in Azure |
214214
| `disksToInclude` | Yes* | List of disks to replicate with their configuration |
215215
| `disksDefault` | Yes* | Default disk configuration (use either `disksToInclude` or `disksDefault`, not both) |
216-
| `targetNetworkId` | No | ARM ID of the target virtual network |
217-
| `testNetworkId` | No | ARM ID of the test virtual network |
216+
| `targetNetworkId` | No | Azure Resource Manager ID of the target virtual network |
217+
| `testNetworkId` | No | Azure Resource Manager ID of the test virtual network |
218218
| `targetSubnetName` | No | Name of the target subnet |
219219
| `testSubnetName` | No | Name of the test subnet |
220220
| `targetVmName` | No | Name for the target Azure VM |
221221
| `targetVmSize` | No | Azure VM size (e.g., `Standard_D2s_v3`) |
222222
| `licenseType` | No | License type: `NoLicenseType`, `WindowsServer` |
223223
| `sqlServerLicenseType` | No | SQL Server license: `NotSpecified`, `NoLicenseType`, `PAYG`, `AHUB` |
224224
| `linuxLicenseType` | No | Linux license: `NotSpecified`, `NoLicenseType`, `RHEL_BYOS`, `SLES_BYOS` |
225-
| `targetAvailabilitySetId` | No | ARM ID of target availability set |
225+
| `targetAvailabilitySetId` | No | Azure Resource Manager ID of target availability set |
226226
| `targetAvailabilityZone` | No | Target availability zone (1, 2, or 3) |
227-
| `targetProximityPlacementGroupId` | No | ARM ID of target proximity placement group |
228-
| `targetBootDiagnosticsStorageAccountId` | No | ARM ID of boot diagnostics storage account |
229-
| `runAsAccountId` | No | ARM ID of the run-as account for mobility agent installation |
227+
| `targetProximityPlacementGroupId` | No | Azure Resource Manager ID of target proximity placement group |
228+
| `targetBootDiagnosticsStorageAccountId` | No | Azure Resource Manager ID of boot diagnostics storage account |
229+
| `runAsAccountId` | No | Azure Resource Manager ID of the run-as account for mobility agent installation |
230230
| `multiVmGroupName` | No | Multi-VM consistency group name |
231231
| `targetVmTags` | No | Tags to apply to the target VM |
232232
| `seedManagedDiskTags` | No | Tags for seed managed disks |
@@ -241,16 +241,16 @@ When using `disksToInclude`, each disk object requires:
241241
|-----------|----------|-------------|
242242
| `diskId` | Yes | UUID of the disk to replicate |
243243
| `diskType` | Yes | Target disk type: `Standard_LRS`, `Premium_LRS`, `StandardSSD_LRS`, `Premium_ZRS`, `StandardSSD_ZRS` |
244-
| `logStorageAccountId` | Yes | ARM ID of the cache storage account for replication |
245-
| `diskEncryptionSetId` | No | ARM ID of disk encryption set for server-side encryption |
244+
| `logStorageAccountId` | Yes | Azure Resource Manager ID of the cache storage account for replication |
245+
| `diskEncryptionSetId` | No | Azure Resource Manager ID of disk encryption set for server-side encryption |
246246

247247
When using `disksDefault`:
248248

249249
| Parameter | Required | Description |
250250
|-----------|----------|-------------|
251251
| `diskType` | Yes | Default disk type for all disks |
252-
| `logStorageAccountId` | Yes | ARM ID of the cache storage account |
253-
| `diskEncryptionSetId` | No | ARM ID of default disk encryption set |
252+
| `logStorageAccountId` | Yes | Azure Resource Manager ID of the cache storage account |
253+
| `diskEncryptionSetId` | No | Azure Resource Manager ID of default disk encryption set |
254254

255255
### Response
256256

@@ -340,13 +340,13 @@ PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups
340340
| `instanceType` | Must be `InMageRcm` |
341341
| `targetVmName` | Updated name for the target Azure VM |
342342
| `targetVmSize` | Updated Azure VM size |
343-
| `targetResourceGroupId` | Updated target resource group ARM ID |
344-
| `targetNetworkId` | Updated target virtual network ARM ID |
345-
| `testNetworkId` | Updated test virtual network ARM ID |
346-
| `targetAvailabilitySetId` | Updated availability set ARM ID (set to empty string to remove) |
343+
| `targetResourceGroupId` | Updated target resource group Azure Resource Manager ID |
344+
| `targetNetworkId` | Updated target virtual network Azure Resource Manager ID |
345+
| `testNetworkId` | Updated test virtual network Azure Resource Manager ID |
346+
| `targetAvailabilitySetId` | Updated availability set Azure Resource Manager ID (set to empty string to remove) |
347347
| `targetAvailabilityZone` | Updated availability zone (set to empty string to remove) |
348-
| `targetProximityPlacementGroupId` | Updated proximity placement group ARM ID |
349-
| `targetBootDiagnosticsStorageAccountId` | Updated boot diagnostics storage account ARM ID |
348+
| `targetProximityPlacementGroupId` | Updated proximity placement group Azure Resource Manager ID |
349+
| `targetBootDiagnosticsStorageAccountId` | Updated boot diagnostics storage account Azure Resource Manager ID |
350350
| `licenseType` | Updated license type |
351351
| `sqlServerLicenseType` | Updated SQL Server license type |
352352
| `linuxLicenseType` | Updated Linux license type |
@@ -371,7 +371,7 @@ PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups
371371
## Step 3: Test migration
372372

373373
> [!IMPORTANT]
374-
> Always perform a test migration (test failover) before initiating an actual migration to validate configuration and minimize production impact.
374+
> Always perform a test migration (test failover) before initiating an actual migration to validate configuration.
375375
376376
Use the [Test Failover](/rest/api/site-recovery/replication-protected-items/test-failover) API.
377377

@@ -405,8 +405,8 @@ Take a recovery point from the latest processed recovery point to minimize data
405405
| Parameter | Required | Description |
406406
|-----------|----------|-------------|
407407
| `instanceType` | Yes | Must be `InMageRcm` |
408-
| `networkId` | No | ARM ID of the test network. If not specified, uses the configured test network. |
409-
| `recoveryPointId` | No | ARM ID of a specific recovery point. Leave empty for the latest recovery point. |
408+
| `networkId` | No | Azure Resource Manager ID of the test network. If not specified, uses the configured test network. |
409+
| `recoveryPointId` | No | Azure Resource Manager ID of a specific recovery point. Leave empty for the latest recovery point. |
410410
| `osUpgradeVersion` | No | Target OS version for in-place OS upgrade during test migration |
411411

412412
### Response
@@ -474,10 +474,10 @@ POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/
474474
| Parameter | Required | Description |
475475
|-----------|----------|-------------|
476476
| `instanceType` | Yes | Must be `InMageRcm` |
477-
| `recoveryPointId` | No | ARM ID of recovery point to fail over to. Leave empty for latest. |
477+
| `recoveryPointId` | No | Azure Resource Manager ID of recovery point to fail over to. Leave empty for latest. |
478478
| `performShutdown` | No | Whether to shut down the source VM before failover (recommended for minimal data loss) |
479479
| `osUpgradeVersion` | No | Target OS version for in-place OS upgrade during migration |
480-
| `targetCapacityReservationGroupId` | No | ARM ID of target capacity reservation group |
480+
| `targetCapacityReservationGroupId` | No | Azure Resource Manager ID of target capacity reservation group |
481481

482482
### Response
483483

@@ -525,7 +525,7 @@ Common error scenarios and resolutions:
525525
| Error | Resolution |
526526
|-------|------------|
527527
| `InvalidParameter` | Verify all required parameters are provided with valid values |
528-
| `ResourceNotFound` | Ensure all ARM resource IDs are correct and resources exist |
528+
| `ResourceNotFound` | Ensure all Azure Resource Manager resource IDs are correct and resources exist |
529529
| `ReplicationNotHealthy` | Check replication health before test/actual migration |
530530
| `RecoveryPointNotFound` | Use the latest recovery point or verify the specified recovery point exists |
531531

@@ -582,7 +582,7 @@ $enableResponse = Invoke-RestMethod -Uri $enableUri -Method Put -Headers $header
582582
- **Run a test migration first**: Always perform a test migration to validate the configuration before starting the actual migration.
583583
- **Use appropriate recovery points**: To minimize data loss, select the latest processed recovery point.
584584
- **Monitor replication health**: Verify that replication is healthy before you initiate migration.
585-
- **Plan maintenance windows**: Schedule migrations during planned maintenance windows to reduce impact on workloads.
585+
- **Plan maintenance windows**: Schedule migrations during planned maintenance windows.
586586
- **Migrate in batches**: Group virtual machines into multi-VM consistency groups to enable application-consistent migrations.
587587
- **Retain recovery points until validation**: Keep recovery points until the migration is validated in the production environment.
588588

0 commit comments

Comments
 (0)