# 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 DataProtectionBackupClient Deleted Backup…
  version: 1.0.0
extends: openapi/microsoft-azure-deletedbackupinstances-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.DataProtection/backupVaults/{vaultName}/deletedBackupInstances'].get
  update:
    x-apievangelist-phrasing:
      intent: List soft-deleted backup instances in a vault
      effect: read
      questions:
      - Which deleted backup instances can I still recover from my backup vault?
      - Can I see the soft-deleted items in a Data Protection backup vault?
      instructions:
      - text: List deleted backup instances in backup vault {vaultName}.
        slots:
          vaultName: path.vaultName
      - text: Show soft-deleted backups I can restore from vault {vaultName}.
        slots:
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/deletedBackupInstances/{backupInstanceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a soft-deleted backup instance
      effect: read
      questions:
      - When was a particular backup instance deleted and is it still recoverable?
      - Can I inspect one deleted backup instance by name?
      instructions:
      - text: Get deleted backup instance {backupInstanceName} in vault {vaultName}.
        slots:
          backupInstanceName: path.backupInstanceName
          vaultName: path.vaultName
      - text: Show the details of soft-deleted backup {backupInstanceName} in {vaultName}.
        slots:
          backupInstanceName: path.backupInstanceName
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/deletedBackupInstances/{backupInstanceName}/undelete'].post
  update:
    x-apievangelist-phrasing:
      intent: Undelete a soft-deleted backup instance
      effect: write
      questions:
      - How do I recover a backup instance I deleted by accident?
      - Can I restore a soft-deleted backup instance back into my vault?
      instructions:
      - text: Undelete backup instance {backupInstanceName} in vault {vaultName}.
        slots:
          backupInstanceName: path.backupInstanceName
          vaultName: path.vaultName
      - text: Bring back the deleted backup {backupInstanceName} in {vaultName}.
        slots:
          backupInstanceName: path.backupInstanceName
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'