# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure SiteRecoveryManagementClient Replication…
  version: 1.0.0
extends: openapi/microsoft-azure-replicationmigrationitems-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 12
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems'].get
  update:
    x-apievangelist-phrasing:
      intent: List migration items in a protection container
      effect: read
      questions:
      - Which machines are being migrated inside one Site Recovery protection container?
      - Can I page through or filter migration items in a protection container?
      instructions:
      - text: List migration items in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Show container {protectionContainerName} migration items in {resourceGroupName} of subscription {subscriptionId} matching {filter}.
        slots:
          protectionContainerName: path.protectionContainerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a migration item
      effect: read
      questions:
      - How do I check the state of one machine I'm migrating with Site Recovery?
      - What details does a single migration item show?
      instructions:
      - text: Get migration item {migrationItemName} in container {protectionContainerName} on fabric {fabricName} in vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Show migration item {migrationItemName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable migration for a machine
      effect: write
      questions:
      - Can I start protecting a machine for migration with Site Recovery?
      - What does it take to create a new migration item?
      instructions:
      - text: Enable migration for {migrationItemName} in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Create migration item {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a migration item
      effect: destructive
      questions:
      - Can I stop migrating a machine and remove its migration item?
      - Is there a delete option that controls how a migration item is removed?
      instructions:
      - text: Delete migration item {migrationItemName} in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Remove migration item {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} using delete option {deleteOption}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          deleteOption: query.deleteOption
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update recovery settings of a migration item
      effect: write
      questions:
      - Can I change the recovery settings of a machine that is already set up for migration?
      - Which target settings can I adjust on an existing migration item?
      instructions:
      - text: Update recovery settings of migration item {migrationItemName} in container {protectionContainerName} on fabric {fabricName} in vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Patch migration item {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}/migrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate a machine
      effect: write
      questions:
      - How do I kick off the actual migration of a replicated machine?
      - When I'm ready to cut over, what starts the real migration of the item?
      instructions:
      - text: Migrate item {migrationItemName} in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Start the cutover for {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}/pauseReplication'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause replication of a migration item
      effect: write
      questions:
      - Can I temporarily pause replication for a machine I'm migrating?
      - Is there a way to put a migration item's replication on hold?
      instructions:
      - text: Pause replication for {migrationItemName} in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Pause migration replication of {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}/resumeReplication'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume replication of a migration item
      effect: write
      questions:
      - How do I resume replication I paused on a migration item?
      - Can replication pick back up for a machine after a pause?
      instructions:
      - text: Resume replication for {migrationItemName} in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Restart paused replication of {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}/resync'].post
  update:
    x-apievangelist-phrasing:
      intent: Resynchronize a migration item
      effect: write
      questions:
      - What do I do when a migrating machine's replication falls out of sync?
      - Can I force a resync of replication for a migration item?
      instructions:
      - text: Resync migration item {migrationItemName} in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Resynchronize replication of {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}/testMigrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a test migration
      effect: write
      questions:
      - Can I do a trial migration before the real cutover?
      - How do I test-migrate a machine without affecting the source?
      instructions:
      - text: Test migrate {migrationItemName} in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Run a test migration of {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationMigrationItems/{migrationItemName}/testMigrateCleanup'].post
  update:
    x-apievangelist-phrasing:
      intent: Clean up a test migration
      effect: write
      questions:
      - How do I clean up the resources a test migration created?
      - What should I run after finishing a test migration?
      instructions:
      - text: Clean up the test migration of {migrationItemName} in container {protectionContainerName} on fabric {fabricName} of vault {resourceName}.
        slots:
          migrationItemName: path.migrationItemName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
      - text: Tear down test migrate for {migrationItemName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          migrationItemName: path.migrationItemName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationMigrationItems'].get
  update:
    x-apievangelist-phrasing:
      intent: List migration items across a vault
      effect: read
      questions:
      - Which machines are being migrated anywhere in my Recovery Services vault?
      - Can I filter all of a vault's migration items without naming a container?
      instructions:
      - text: List all migration items in vault {resourceName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show vault {resourceName} migration items matching {filter}.
        slots:
          resourceName: path.resourceName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'