# 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 RecoveryServicesBackupClient Data Move API
  version: 1.0.0
extends: openapi/microsoft-azure-datamove-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupstorageconfig/vaultstorageconfig/operationStatus/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of a vault data move operation
      effect: read
      questions:
      - Is my Recovery Services vault data move operation finished yet?
      - Can I poll the progress of a backup data move by its operation ID?
      instructions:
      - text: Get the status of data move operation {operationId} on vault {vaultName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          operationId: path.operationId
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Check whether data move {operationId} on Recovery Services vault {vaultName} has completed.
        slots:
          operationId: path.operationId
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupstorageconfig/vaultstorageconfig/prepareDataMove'].post
  update:
    x-apievangelist-phrasing:
      intent: Prepare a source vault for a data move
      effect: write
      questions:
      - What must I do on the source vault before moving backup data to another region?
      - Can I prepare a vault data move for only some containers?
      instructions:
      - text: Prepare vault {vaultName} in {resourceGroupName}, subscription {subscriptionId} to move data to {targetResourceId} in {targetRegion}.
        slots:
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          targetResourceId: requestBody.targetResourceId
          targetRegion: requestBody.targetRegion
      - text: Prepare source vault {vaultName} for a {dataMoveLevel}-level data move to region {targetRegion}.
        slots:
          vaultName: path.vaultName
          dataMoveLevel: requestBody.dataMoveLevel
          targetRegion: requestBody.targetRegion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupstorageconfig/vaultstorageconfig/triggerDataMove'].post
  update:
    x-apievangelist-phrasing:
      intent: Trigger a data move on the target vault
      effect: write
      questions:
      - How do I start moving backup data into the target Recovery Services vault?
      - What correlation ID do I pass when triggering a vault data move?
      instructions:
      - text: Trigger the data move into vault {vaultName} in {resourceGroupName}, subscription {subscriptionId} from {sourceResourceId} in {sourceRegion}.
        slots:
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          sourceResourceId: requestBody.sourceResourceId
          sourceRegion: requestBody.sourceRegion
      - text: Start a {dataMoveLevel}-level data move on target vault {vaultName} with correlation ID {correlationId}.
        slots:
          dataMoveLevel: requestBody.dataMoveLevel
          vaultName: path.vaultName
          correlationId: requestBody.correlationId
      method: generated
      generated: '2026-09-26'