# 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 KeyVaultClient Deleted Storage API
  version: 1.0.0
extends: openapi/microsoft-azure-deletedstorage-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: 7
- target: $.paths['/deletedstorage'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted storage accounts in a Key Vault
      effect: read
      questions:
      - Which managed storage accounts were soft-deleted from my Key Vault?
      - Can I cap how many deleted storage accounts come back per page?
      instructions:
      - text: List the deleted storage accounts in this vault.
      - text: List up to {max} soft-deleted storage accounts in the vault.
        slots:
          max: query.maxresults
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deletedstorage/{storage-account-name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted storage account from a Key Vault
      effect: read
      questions:
      - When was a managed storage account deleted from my vault, and when will it be purged?
      - Can I see the attributes of one soft-deleted storage account?
      instructions:
      - text: Get deleted storage account {account} from the vault.
        slots:
          account: path.storage-account-name
      - text: Show the scheduled purge date of deleted storage account {account}.
        slots:
          account: path.storage-account-name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deletedstorage/{storage-account-name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently purge a deleted storage account
      effect: destructive
      questions:
      - How do I permanently remove a soft-deleted storage account from Key Vault?
      - Is purging a deleted storage account reversible?
      instructions:
      - text: Purge deleted storage account {account} permanently.
        slots:
          account: path.storage-account-name
      - text: Irreversibly erase soft-deleted storage account {account} from the vault.
        slots:
          account: path.storage-account-name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deletedstorage/{storage-account-name}/recover'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover a deleted storage account
      effect: write
      questions:
      - Can I undo the deletion of a managed storage account in my Key Vault?
      - How do I restore a soft-deleted storage account?
      instructions:
      - text: Recover deleted storage account {account}.
        slots:
          account: path.storage-account-name
      - text: Restore soft-deleted storage account {account} back into the vault.
        slots:
          account: path.storage-account-name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deletedstorage/{storage-account-name}/sas'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted SAS definitions for a storage account
      effect: read
      questions:
      - Which SAS definitions were deleted for a storage account in my vault?
      - Can I limit the number of deleted SAS definitions returned?
      instructions:
      - text: List deleted SAS definitions for storage account {account}.
        slots:
          account: path.storage-account-name
      - text: List up to {max} soft-deleted SAS definitions of storage account {account}.
        slots:
          max: query.maxresults
          account: path.storage-account-name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deletedstorage/{storage-account-name}/sas/{sas-definition-name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted SAS definition
      effect: read
      questions:
      - What were the attributes of a SAS definition I deleted?
      - When will a soft-deleted SAS definition be purged?
      instructions:
      - text: Get deleted SAS definition {sas} for storage account {account}.
        slots:
          sas: path.sas-definition-name
          account: path.storage-account-name
      - text: Show the purge date of deleted SAS definition {sas} on account {account}.
        slots:
          sas: path.sas-definition-name
          account: path.storage-account-name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deletedstorage/{storage-account-name}/sas/{sas-definition-name}/recover'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover a deleted SAS definition
      effect: write
      questions:
      - Can I bring back a SAS definition that was deleted from a storage account?
      - How do I restore a soft-deleted SAS definition in Key Vault?
      instructions:
      - text: Recover deleted SAS definition {sas} for storage account {account}.
        slots:
          sas: path.sas-definition-name
          account: path.storage-account-name
      - text: Restore SAS definition {sas} on account {account} from the deleted state.
        slots:
          sas: path.sas-definition-name
          account: path.storage-account-name
      method: generated
      generated: '2026-09-26'