# 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 Backups API
  version: 1.0.0
extends: openapi/microsoft-azure-backups-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 19
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Backup.Admin/backupLocations/{location}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Stack infrastructure backups at a location
      effect: read
      questions:
      - Which infrastructure backups exist at my Azure Stack Hub backup location?
      - Can I see every admin backup stored at one backup location?
      instructions:
      - text: List the infrastructure backups stored at Azure Stack backup location {location}.
        slots:
          location: path.location
      - text: Show all admin backups kept at the backup location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Backup.Admin/backupLocations/{location}/backups/{backup}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one infrastructure backup at a backup location
      effect: read
      questions:
      - How do I look up a single Azure Stack infrastructure backup by its name?
      - What details does an admin backup at a backup location report?
      instructions:
      - text: Get infrastructure backup {backup} from backup location {location}.
        slots:
          backup: path.backup
          location: path.location
      - text: Show the details of Azure Stack admin backup {backup}.
        slots:
          backup: path.backup
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Backup.Admin/backupLocations/{location}/backups/{backup}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore an Azure Stack infrastructure backup
      effect: write
      questions:
      - Can I restore Azure Stack Hub infrastructure from an admin backup?
      - What restore options are required to restore an infrastructure backup?
      instructions:
      - text: Restore infrastructure backup {backup} using restore options {restoreOptions}.
        slots:
          backup: path.backup
          restoreOptions: body.restoreOptions
      - text: Start an admin restore of Azure Stack backup {backup} at location {location}.
        slots:
          backup: path.backup
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/latestBackupStatus/current'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the latest backup status of a NetApp volume
      effect: read
      questions:
      - What is the latest backup status of my Azure NetApp Files volume?
      - Is the most recent backup of a NetApp volume healthy or still running?
      instructions:
      - text: Get the latest backup status for volume {volumeName} in pool {poolName} of NetApp account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Check how the last backup of NetApp volume {volumeName} went.
        slots:
          volumeName: path.volumeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupVaults/{backupVaultName}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List backups in a NetApp backup vault
      effect: read
      questions:
      - Which backups are stored in my NetApp backup vault?
      - Can I filter a backup vault's backups down to one volume?
      instructions:
      - text: List all backups in backup vault {backupVaultName} of NetApp account {accountName}.
        slots:
          backupVaultName: path.backupVaultName
          accountName: path.accountName
      - text: List backups in vault {backupVaultName} under account {accountName} for the volume matching {filter}.
        slots:
          backupVaultName: path.backupVaultName
          accountName: path.accountName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupVaults/{backupVaultName}/backups/{backupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backup from a NetApp backup vault
      effect: read
      questions:
      - How do I see the details of one backup in a NetApp backup vault?
      - What size and creation time does a specific vault backup show?
      instructions:
      - text: Get backup {backupName} from backup vault {backupVaultName} in NetApp account {accountName}.
        slots:
          backupName: path.backupName
          backupVaultName: path.backupVaultName
          accountName: path.accountName
      - text: Describe NetApp vault backup {backupName}.
        slots:
          backupName: path.backupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupVaults/{backupVaultName}/backups/{backupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a backup in a NetApp backup vault
      effect: write
      questions:
      - Can I take an on-demand Azure NetApp Files backup into a backup vault?
      - What properties does creating a new vault backup require?
      instructions:
      - text: Create backup {backupName} in backup vault {backupVaultName} of NetApp account {accountName}.
        slots:
          backupName: path.backupName
          backupVaultName: path.backupVaultName
          accountName: path.accountName
      - text: Back up to vault {backupVaultName} as {backupName} with properties {properties}.
        slots:
          backupName: path.backupName
          backupVaultName: path.backupVaultName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupVaults/{backupVaultName}/backups/{backupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a backup from a NetApp backup vault
      effect: destructive
      questions:
      - How do I remove an old backup from a NetApp backup vault?
      - Is deleting a vault backup under a NetApp account permanent?
      instructions:
      - text: Delete backup {backupName} from NetApp backup vault {backupVaultName} in account {accountName}.
        slots:
          backupName: path.backupName
          backupVaultName: path.backupVaultName
          accountName: path.accountName
      - text: Remove vault backup {backupName} for good.
        slots:
          backupName: path.backupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupVaults/{backupVaultName}/backups/{backupName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a backup in a NetApp backup vault
      effect: write
      questions:
      - Can I change the label on an existing NetApp vault backup?
      - Which fields of a backup already in a backup vault can be patched?
      instructions:
      - text: Patch backup {backupName} in NetApp vault {backupVaultName} with {properties}.
        slots:
          backupName: path.backupName
          backupVaultName: path.backupVaultName
          properties: requestBody.properties
      - text: Update the existing vault backup {backupName} under NetApp account {accountName}.
        slots:
          backupName: path.backupName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupVaults/{backupVaultName}/backups/{backupName}/restoreFiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore individual files from a NetApp backup
      effect: write
      questions:
      - Can I restore just a few files from a NetApp backup instead of the whole volume?
      - Which destination volume and folder do restored backup files land in?
      instructions:
      - text: Restore files {fileList} from backup {backupName} in vault {backupVaultName} to volume {destinationVolumeId}.
        slots:
          fileList: requestBody.fileList
          backupName: path.backupName
          backupVaultName: path.backupVaultName
          destinationVolumeId: requestBody.destinationVolumeId
      - text: Put files {fileList} from backup {backupName} back into folder {restoreFilePath} on volume {destinationVolumeId}.
        slots:
          fileList: requestBody.fileList
          backupName: path.backupName
          restoreFilePath: requestBody.restoreFilePath
          destinationVolumeId: requestBody.destinationVolumeId
      - text: Recover selected files from vault backup {backupName} in NetApp account {accountName}.
        slots:
          backupName: path.backupName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/migrateBackups'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate a NetApp volume's backups to a backup vault
      effect: write
      questions:
      - How do I move the backups of a single NetApp volume into a backup vault?
      - Can one volume's legacy backups be migrated without touching the rest of the account?
      instructions:
      - text: Migrate the backups of volume {volumeName} in pool {poolName} of account {accountName} to backup vault {backupVaultId}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
          backupVaultId: requestBody.backupVaultId
      - text: Move volume {volumeName}'s backups into vault {backupVaultId}.
        slots:
          volumeName: path.volumeName
          backupVaultId: requestBody.backupVaultId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/migrateBackups'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate all backups in a NetApp account to a vault
      effect: write
      questions:
      - Can I migrate every backup under a whole NetApp account into a backup vault at once?
      - What does an account-wide backup migration need besides the vault's resource ID?
      instructions:
      - text: Migrate all backups under NetApp account {accountName} to backup vault {backupVaultId}.
        slots:
          accountName: path.accountName
          backupVaultId: requestBody.backupVaultId
      - text: Move every backup in account {accountName} into vault {backupVaultId} in one request.
        slots:
          accountName: path.accountName
          backupVaultId: requestBody.backupVaultId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/backup'].post
  update:
    x-apievangelist-phrasing:
      intent: Trigger an on-demand backup of a protected item
      effect: write
      questions:
      - How do I start an ad-hoc backup of a protected item in a Recovery Services vault?
      - Is triggering a Recovery Services backup asynchronous, and how do I track it?
      instructions:
      - text: Trigger a backup of protected item {protectedItemName} in container {containerName}, fabric {fabricName}, vault {vaultName}.
        slots:
          protectedItemName: path.protectedItemName
          containerName: path.containerName
          fabricName: path.fabricName
          vaultName: path.vaultName
      - text: Back up item {protectedItemName} now in vault {vaultName} of resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          protectedItemName: path.protectedItemName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List backups on a StorSimple device
      effect: read
      questions:
      - Which backups exist on one StorSimple device?
      - Can I filter a StorSimple device's backup list with an OData expression?
      instructions:
      - text: List backups on StorSimple device {deviceName} in manager {managerName}.
        slots:
          deviceName: path.deviceName
          managerName: path.managerName
      - text: List backups on device {deviceName} of manager {managerName} in resource group {resourceGroupName}, subscription {subscriptionId}, filtered by {filter}.
        slots:
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backups/{backupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a backup from a StorSimple device
      effect: destructive
      questions:
      - How do I delete an old backup from a StorSimple device?
      - Does removing a StorSimple device backup free it from the manager too?
      instructions:
      - text: Delete backup {backupName} from StorSimple device {deviceName} in manager {managerName}.
        slots:
          backupName: path.backupName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Remove device backup {backupName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          backupName: path.backupName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backups/{backupName}/elements/{backupElementName}/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a StorSimple 8000 backup element to a new volume
      effect: write
      questions:
      - Can I clone a StorSimple 8000 series backup element into a new volume on another device?
      - What access control records does a cloned StorSimple volume need?
      instructions:
      - text: Clone backup element {backupElementName} of backup {backupName} to new volume {targetVolumeName} on device {targetDeviceId}.
        slots:
          backupElementName: path.backupElementName
          backupName: path.backupName
          targetVolumeName: requestBody.targetVolumeName
          targetDeviceId: requestBody.targetDeviceId
      - text: Create volume {targetVolumeName} from element {backupElementName} of backup {backupName} with access records {targetAccessControlRecordIds}.
        slots:
          targetVolumeName: requestBody.targetVolumeName
          backupElementName: path.backupElementName
          backupName: path.backupName
          targetAccessControlRecordIds: requestBody.targetAccessControlRecordIds
      - text: Clone 8000 series element {backupElementName} on device {deviceName}, manager {managerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          backupElementName: path.backupElementName
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backups/{backupName}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a backup onto a StorSimple device
      effect: write
      questions:
      - How can I roll a StorSimple device back to one of its backups?
      - Does restoring a StorSimple backup overwrite what is on the device now?
      instructions:
      - text: Restore backup set {backupName} on StorSimple device {deviceName} in manager {managerName}.
        slots:
          backupName: path.backupName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Restore device {deviceName} from backup {backupName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          backupName: path.backupName
          deviceName: path.deviceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List all backups across a StorSimple manager
      effect: read
      questions:
      - Which backups exist across every device in my StorSimple manager?
      - Can I get one list of backups for a whole StorSimple manager rather than per device?
      instructions:
      - text: List all backups in StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      - text: List backups across manager {managerName} in resource group {resourceGroupName}, subscription {subscriptionId} matching {filter}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backups/{backupName}/elements/{elementName}/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a StorSimple backup element to a disk or share
      effect: write
      questions:
      - Can I clone a StorSimple virtual array backup element into a new disk or file share?
      - What clone request details are needed to turn a backup element into a share?
      instructions:
      - text: Clone element {elementName} of backup {backupName} on device {deviceName} to a new disk or share using {properties}.
        slots:
          elementName: path.elementName
          backupName: path.backupName
          deviceName: path.deviceName
          properties: requestBody.properties
      - text: Make a new share from element {elementName} of backup {backupName} in manager {managerName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          elementName: path.elementName
          backupName: path.backupName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          managerName: path.managerName
      method: generated
      generated: '2026-09-26'