# 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 Snapshots API
  version: 1.0.0
extends: openapi/microsoft-azure-snapshots-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: 29
- target: $.paths['/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Configuration key-value snapshots
      effect: read
      questions:
      - Which key-value snapshots exist in my App Configuration store?
      - Can I list only the archived or ready configuration snapshots?
      - Is there a way to pick which fields come back when listing key-value snapshots?
      instructions:
      - text: List the key-value snapshots whose name matches {name}.
        slots:
          name: query.name
      - text: List configuration snapshots in status {status}.
        slots:
          status: query.Status
      - text: Show all of my App Configuration snapshots.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots'].post
  update:
    x-apievangelist-phrasing:
      intent: Take a snapshot of a Face person group or face list
      effect: write
      questions:
      - How do I back up a Face person group so another subscription can restore it?
      - Can I snapshot a large face list and share it only with specific subscriptions?
      - What Face objects can be captured in a snapshot for migration?
      instructions:
      - text: Take a {type} snapshot of Face object {objectId} shared with subscriptions {applyScope}.
        slots:
          type: requestBody.type
          objectId: requestBody.objectId
          applyScope: requestBody.applyScope
      - text: Back up person group {objectId} as a {type} snapshot for subscriptions {applyScope} with note {userData}.
        slots:
          objectId: requestBody.objectId
          type: requestBody.type
          applyScope: requestBody.applyScope
          userData: requestBody.userData
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots'].head
  update:
    x-apievangelist-phrasing:
      intent: Check headers of the key-value snapshot listing
      effect: read
      questions:
      - Can I check the App Configuration snapshot collection's headers without downloading the list?
      - What does a HEAD request on the configuration snapshots collection tell me?
      instructions:
      - text: Check the snapshot collection headers starting after {after}.
        slots:
          after: query.After
      - text: Fetch only the response headers for the configuration snapshot listing using sync token {sync_token}.
        slots:
          sync_token: header.Sync-Token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one App Configuration key-value snapshot
      effect: read
      questions:
      - What filters and retention settings does a specific configuration snapshot have?
      - Can I fetch a key-value snapshot only when its ETag has changed?
      instructions:
      - text: Get key-value snapshot {name}.
        slots:
          name: path.name
      - text: Get key-value snapshot {name} unless it still matches ETag {etag}.
        slots:
          name: path.name
          etag: header.If-None-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an App Configuration key-value snapshot
      effect: write
      questions:
      - How do I freeze a set of configuration key-values into a named snapshot?
      - Can I set a retention period when creating a configuration snapshot?
      - Which key filters decide what goes into a new key-value snapshot?
      instructions:
      - text: Create key-value snapshot {name} from key filters {filters}.
        slots:
          name: path.name
          filters: requestBody.filters
      - text: Create configuration snapshot {name} using filters {filters} with retention period {retention_period}.
        slots:
          name: path.name
          filters: requestBody.filters
          retention_period: requestBody.retention_period
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Archive or recover a key-value snapshot
      effect: write
      questions:
      - Can I archive a configuration snapshot I no longer need?
      - How do I recover an archived key-value snapshot back to ready?
      instructions:
      - text: Set the status of key-value snapshot {name} to {status}.
        slots:
          name: path.name
          status: requestBody.status
      - text: Change configuration snapshot {name} to status {status} only if its ETag is {etag}.
        slots:
          name: path.name
          status: requestBody.status
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots/{name}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check whether a key-value snapshot exists
      effect: read
      questions:
      - Can I confirm a configuration snapshot exists without fetching its body?
      - How can I read just the ETag headers of one key-value snapshot?
      instructions:
      - text: Check whether key-value snapshot {name} exists.
        slots:
          name: path.name
      - text: Check the headers of configuration snapshot {name} against ETag {etag}.
        slots:
          name: path.name
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerStorage/pools/{poolName}/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List snapshots in a Container Storage pool
      effect: read
      questions:
      - Which snapshots have been taken in my Azure Container Storage pool?
      - Where can I see every snapshot belonging to one container storage pool?
      instructions:
      - text: List snapshots in container storage pool {poolName}.
        slots:
          poolName: path.poolName
      - text: Show every snapshot stored in storage pool {poolName}.
        slots:
          poolName: path.poolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerStorage/pools/{poolName}/snapshots/{snapshotName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Container Storage pool snapshot
      effect: read
      questions:
      - What are the details of one snapshot in my container storage pool?
      - Can I check the state of a specific storage pool snapshot?
      instructions:
      - text: Get snapshot {snapshotName} from container storage pool {poolName}.
        slots:
          snapshotName: path.snapshotName
          poolName: path.poolName
      - text: Show details of storage pool {poolName} snapshot {snapshotName}.
        slots:
          poolName: path.poolName
          snapshotName: path.snapshotName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerStorage/pools/{poolName}/snapshots/{snapshotName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Container Storage pool snapshot
      effect: write
      questions:
      - How do I take a snapshot of a volume in Azure Container Storage?
      - Can I create a named snapshot inside a specific container storage pool?
      instructions:
      - text: Create snapshot {snapshotName} in container storage pool {poolName}.
        slots:
          snapshotName: path.snapshotName
          poolName: path.poolName
      - text: Snapshot container storage pool {poolName} as {snapshotName} with properties {properties}.
        slots:
          poolName: path.poolName
          snapshotName: path.snapshotName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerStorage/pools/{poolName}/snapshots/{snapshotName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Container Storage pool snapshot
      effect: destructive
      questions:
      - How do I remove an old snapshot from my container storage pool?
      - Can I delete one snapshot without touching the rest of the storage pool?
      instructions:
      - text: Delete snapshot {snapshotName} from container storage pool {poolName}.
        slots:
          snapshotName: path.snapshotName
          poolName: path.poolName
      - text: Remove the storage pool {poolName} snapshot named {snapshotName}.
        slots:
          poolName: path.poolName
          snapshotName: path.snapshotName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots/{snapshotName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed disk snapshot
      effect: read
      questions:
      - What size, SKU and source disk does one of my disk snapshots have?
      - Can I look up a compute disk snapshot by name?
      instructions:
      - text: Get managed disk snapshot {snapshotName}.
        slots:
          snapshotName: path.snapshotName
      - text: Show the properties of compute disk snapshot {snapshotName}.
        slots:
          snapshotName: path.snapshotName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots/{snapshotName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a managed disk snapshot
      effect: write
      questions:
      - How do I take a snapshot of a managed disk in Azure?
      - Can I choose the storage SKU when creating a disk snapshot?
      instructions:
      - text: Create managed disk snapshot {snapshotName} with properties {properties}.
        slots:
          snapshotName: path.snapshotName
          properties: requestBody.properties
      - text: Create or overwrite disk snapshot {snapshotName} using SKU {sku}.
        slots:
          snapshotName: path.snapshotName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots/{snapshotName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed disk snapshot
      effect: destructive
      questions:
      - How do I delete a disk snapshot I no longer need to pay for?
      - Can I remove a compute snapshot without deleting the source disk?
      instructions:
      - text: Delete managed disk snapshot {snapshotName}.
        slots:
          snapshotName: path.snapshotName
      - text: Remove compute snapshot {snapshotName} from its resource group.
        slots:
          snapshotName: path.snapshotName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots/{snapshotName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags or SKU on a managed disk snapshot
      effect: write
      questions:
      - Can I change the tags on an existing disk snapshot?
      - Is it possible to switch an existing compute snapshot to a different SKU?
      instructions:
      - text: Update the tags on disk snapshot {snapshotName} to {tags}.
        slots:
          snapshotName: path.snapshotName
          tags: requestBody.tags
      - text: Patch managed disk snapshot {snapshotName} to use SKU {sku}.
        slots:
          snapshotName: path.snapshotName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed disk snapshots in a resource group
      effect: read
      questions:
      - Which disk snapshots are sitting in this resource group?
      - Can I see only the compute snapshots in one resource group rather than the whole subscription?
      instructions:
      - text: List the managed disk snapshots in this resource group.
      - text: Show compute snapshots scoped to the current resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Compute/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed disk snapshots across a subscription
      effect: read
      questions:
      - What disk snapshots exist anywhere in my Azure subscription?
      - How many compute snapshots do I have across all resource groups?
      instructions:
      - text: List every managed disk snapshot in my subscription.
      - text: Show compute snapshots from all resource groups in the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots/{snapshotName}/beginGetAccess'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant access to a managed disk snapshot
      effect: write
      questions:
      - How do I get access to a disk snapshot so I can export or copy it?
      - Can I open temporary access to a compute snapshot?
      instructions:
      - text: Grant access to managed disk snapshot {snapshotName}.
        slots:
          snapshotName: path.snapshotName
      - text: Begin get-access on compute snapshot {snapshotName}.
        slots:
          snapshotName: path.snapshotName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots/{snapshotName}/endGetAccess'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke access to a managed disk snapshot
      effect: destructive
      questions:
      - How do I close off access I previously granted to a disk snapshot?
      - Can I end get-access on a compute snapshot once the export is finished?
      instructions:
      - text: Revoke access to managed disk snapshot {snapshotName}.
        slots:
          snapshotName: path.snapshotName
      - text: End get-access on compute snapshot {snapshotName}.
        slots:
          snapshotName: path.snapshotName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots/{snapshotId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Face data snapshot
      effect: read
      questions:
      - Which subscriptions are allowed to apply a Face snapshot I took?
      - What information is stored about a Face person group snapshot?
      instructions:
      - text: Get Face snapshot {snapshotId}.
        slots:
          snapshotId: path.snapshotId
      - text: Show the apply scope and user data of Face snapshot {snapshotId}.
        slots:
          snapshotId: path.snapshotId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots/{snapshotId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Face data snapshot
      effect: destructive
      questions:
      - How do I delete a Face snapshot and the face data it holds?
      - Who is allowed to remove a Face snapshot once it has been taken?
      instructions:
      - text: Delete Face snapshot {snapshotId}.
        slots:
          snapshotId: path.snapshotId
      - text: Remove the backed-up face data in snapshot {snapshotId}.
        slots:
          snapshotId: path.snapshotId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots/{snapshotId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Face snapshot's apply scope or user data
      effect: write
      questions:
      - Can I add another subscription to the apply scope of an existing Face snapshot?
      - How do I change the user data note on a Face snapshot?
      instructions:
      - text: Set the apply scope of Face snapshot {snapshotId} to subscriptions {applyScope}.
        slots:
          snapshotId: path.snapshotId
          applyScope: requestBody.applyScope
      - text: Change the user data on Face snapshot {snapshotId} to {userData}.
        slots:
          snapshotId: path.snapshotId
          userData: requestBody.userData
      method: generated
      generated: '2026-09-26'
- target: $.paths['/snapshots/{snapshotId}/apply'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a Face snapshot into this subscription
      effect: write
      questions:
      - How do I restore a Face person group from a snapshot into my subscription?
      - Can I apply a Face snapshot into a new target object id?
      instructions:
      - text: Apply Face snapshot {snapshotId} to create object {objectId}.
        slots:
          snapshotId: path.snapshotId
          objectId: requestBody.objectId
      - text: Restore Face snapshot {snapshotId} into {objectId} using apply mode {mode}.
        slots:
          snapshotId: path.snapshotId
          objectId: requestBody.objectId
          mode: requestBody.mode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List snapshots of a NetApp Files volume
      effect: read
      questions:
      - What snapshots exist for one of my Azure NetApp Files volumes?
      - Can I see the point-in-time copies taken of a NetApp volume?
      instructions:
      - text: List snapshots of NetApp volume {volumeName} in pool {poolName} under account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Show every snapshot for volume {volumeName} in NetApp capacity pool {poolName} of account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/snapshots/{snapshotName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a NetApp Files volume snapshot
      effect: read
      questions:
      - When was a particular NetApp volume snapshot created?
      - Can I fetch the details of one snapshot on a NetApp Files volume?
      instructions:
      - text: Get NetApp snapshot {snapshotName} of volume {volumeName} in pool {poolName}, account {accountName}.
        slots:
          snapshotName: path.snapshotName
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Describe snapshot {snapshotName} on NetApp volume {volumeName} (account {accountName}, pool {poolName}).
        slots:
          snapshotName: path.snapshotName
          volumeName: path.volumeName
          accountName: path.accountName
          poolName: path.poolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/snapshots/{snapshotName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a NetApp Files volume snapshot
      effect: write
      questions:
      - How do I take a manual snapshot of an Azure NetApp Files volume?
      - Which region do I need to give when creating a NetApp volume snapshot?
      instructions:
      - text: Create NetApp snapshot {snapshotName} of volume {volumeName} in pool {poolName}, account {accountName}, in {location}.
        slots:
          snapshotName: path.snapshotName
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
          location: requestBody.location
      - text: Snapshot NetApp volume {volumeName} as {snapshotName} (account {accountName}, pool {poolName}, region {location}).
        slots:
          volumeName: path.volumeName
          snapshotName: path.snapshotName
          accountName: path.accountName
          poolName: path.poolName
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/snapshots/{snapshotName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a NetApp Files volume snapshot
      effect: destructive
      questions:
      - How do I delete an old snapshot from a NetApp Files volume?
      - Can I free up NetApp volume space by removing a single snapshot?
      instructions:
      - text: Delete NetApp snapshot {snapshotName} from volume {volumeName} in pool {poolName}, account {accountName}.
        slots:
          snapshotName: path.snapshotName
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Remove snapshot {snapshotName} of NetApp volume {volumeName} (account {accountName}, pool {poolName}).
        slots:
          snapshotName: path.snapshotName
          volumeName: path.volumeName
          accountName: path.accountName
          poolName: path.poolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/snapshots/{snapshotName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a NetApp Files volume snapshot
      effect: write
      questions:
      - Can I patch an existing snapshot on a NetApp Files volume?
      - Is there an update call for NetApp volume snapshots after they are created?
      instructions:
      - text: Patch NetApp snapshot {snapshotName} of volume {volumeName} in pool {poolName}, account {accountName}.
        slots:
          snapshotName: path.snapshotName
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Update snapshot {snapshotName} on NetApp volume {volumeName} (account {accountName}, pool {poolName}).
        slots:
          snapshotName: path.snapshotName
          volumeName: path.volumeName
          accountName: path.accountName
          poolName: path.poolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/snapshots/{snapshotName}/restoreFiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore files from a NetApp volume snapshot
      effect: write
      questions:
      - How do I recover a few deleted files from a NetApp snapshot without reverting the whole volume?
      - Can I restore snapshot files to a different directory on the NetApp volume?
      instructions:
      - text: Restore files {filePaths} from snapshot {snapshotName} of NetApp volume {volumeName} (account {accountName}, pool {poolName}).
        slots:
          filePaths: requestBody.filePaths
          snapshotName: path.snapshotName
          volumeName: path.volumeName
          accountName: path.accountName
          poolName: path.poolName
      - text: Copy {filePaths} out of NetApp snapshot {snapshotName} into {destinationPath} on volume {volumeName}, pool {poolName}, account {accountName}.
        slots:
          filePaths: requestBody.filePaths
          snapshotName: path.snapshotName
          destinationPath: requestBody.destinationPath
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'