# 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 Storage Accounts API
  version: 1.0.0
extends: openapi/microsoft-azure-storageaccounts-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: 27
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/storageAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage accounts on a Data Box Edge device
      effect: read
      questions:
      - Which storage accounts are configured on my Data Box Edge or Data Box Gateway device?
      - Can I see every edge storage account a gateway device holds?
      instructions:
      - text: List the storage accounts on Data Box Edge device {device} in resource group {rg}, subscription {sub}.
        slots:
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me all edge storage accounts configured on gateway device {device}.
        slots:
          device: path.deviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/storageAccounts/{storageAccountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storage account on a Data Box Edge device
      effect: read
      questions:
      - What are the settings of one storage account on my Data Box Edge device?
      - Can I look up a single edge storage account by name on a gateway device?
      instructions:
      - text: Get edge storage account {name} on Data Box Edge device {device} in resource group {rg}, subscription {sub}.
        slots:
          name: path.storageAccountName
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the details of storage account {name} on gateway device {device}.
        slots:
          name: path.storageAccountName
          device: path.deviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/storageAccounts/{storageAccountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a storage account on an edge device
      effect: write
      questions:
      - How do I add a storage account to a Data Box Edge device?
      - Can I change the properties of an existing storage account on my gateway device?
      instructions:
      - text: Create storage account {name} on Data Box Edge device {device} in resource group {rg}, subscription {sub} with properties {props}.
        slots:
          name: path.storageAccountName
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          props: requestBody.properties
      - text: 'Update the edge storage account {name} on gateway device {device} with these properties: {props}.'
        slots:
          name: path.storageAccountName
          device: path.deviceName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/storageAccounts/{storageAccountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a storage account from a Data Box Edge device
      effect: destructive
      questions:
      - Can I remove a storage account from my Data Box Edge or Data Box Gateway device?
      - What happens when I delete an edge storage account from a gateway device?
      instructions:
      - text: Delete storage account {name} from Data Box Edge device {device} in resource group {rg}, subscription {sub}.
        slots:
          name: path.storageAccountName
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove edge storage account {name} from gateway device {device}.
        slots:
          name: path.storageAccountName
          device: path.deviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}/storageAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage accounts linked to Data Lake Analytics
      effect: read
      questions:
      - Which Azure Storage accounts are linked to my Data Lake Analytics account?
      - Can I filter, sort or page through the storage accounts attached to a Data Lake Analytics account?
      instructions:
      - text: List the storage accounts linked to Data Lake Analytics account {account} in resource group {rg}, subscription {sub}.
        slots:
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the first {top} linked storage accounts on Data Lake Analytics account {account}, ordered by {orderby}.
        slots:
          top: query.$top
          account: path.accountName
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}/storageAccounts/{storageAccountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storage account linked to Data Lake Analytics
      effect: read
      questions:
      - What are the details of one Azure Storage account linked to my Data Lake Analytics account?
      - Is a particular storage account attached to my Data Lake Analytics account?
      instructions:
      - text: Get linked storage account {storage} on Data Lake Analytics account {account} in resource group {rg}, subscription {sub}.
        slots:
          storage: path.storageAccountName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show how storage account {storage} is linked to Data Lake Analytics account {account}.
        slots:
          storage: path.storageAccountName
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}/storageAccounts/{storageAccountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Link a storage account to Data Lake Analytics
      effect: write
      questions:
      - How do I add an Azure Storage account to my Data Lake Analytics account?
      - What do I need to supply to attach a blob storage account to Data Lake Analytics?
      instructions:
      - text: Add storage account {storage} to Data Lake Analytics account {account} in resource group {rg}, subscription {sub} using {props}.
        slots:
          storage: path.storageAccountName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          props: requestBody.properties
      - text: Link blob storage account {storage} to my Data Lake Analytics account {account} with access key details {props}.
        slots:
          storage: path.storageAccountName
          account: path.accountName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}/storageAccounts/{storageAccountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink a storage account from Data Lake Analytics
      effect: destructive
      questions:
      - Can I detach an Azure Storage account from my Data Lake Analytics account?
      - What is the way to stop Data Lake Analytics from using a linked storage account?
      instructions:
      - text: Remove storage account {storage} from Data Lake Analytics account {account} in resource group {rg}, subscription {sub}.
        slots:
          storage: path.storageAccountName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Unlink storage account {storage} from Data Lake Analytics account {account}.
        slots:
          storage: path.storageAccountName
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}/storageAccounts/{storageAccountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a linked storage account's key or suffix
      effect: write
      questions:
      - How do I rotate the access key Data Lake Analytics uses for a linked storage account?
      - Can I change the endpoint suffix of a storage account already linked to Data Lake Analytics?
      instructions:
      - text: Update the access key and suffix for linked storage account {storage} on Data Lake Analytics account {account} in {rg}, subscription {sub} to {props}.
        slots:
          storage: path.storageAccountName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          props: requestBody.properties
      - text: Replace the blob account details Data Lake Analytics account {account} holds for {storage}.
        slots:
          account: path.accountName
          storage: path.storageAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}/storageAccounts/{storageAccountName}/containers'].get
  update:
    x-apievangelist-phrasing:
      intent: List containers in a linked storage account
      effect: read
      questions:
      - Which blob containers can Data Lake Analytics see in a linked storage account?
      - Can I list the storage containers behind a Data Lake Analytics storage link?
      instructions:
      - text: List the containers in storage account {storage} linked to Data Lake Analytics account {account} in {rg}, subscription {sub}.
        slots:
          storage: path.storageAccountName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every blob container Data Lake Analytics account {account} can reach in {storage}.
        slots:
          account: path.accountName
          storage: path.storageAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}/storageAccounts/{storageAccountName}/containers/{containerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a container in a linked storage account
      effect: read
      questions:
      - What are the details of one container in a storage account linked to Data Lake Analytics?
      - Can I check a specific blob container Data Lake Analytics has access to?
      instructions:
      - text: Get container {container} in storage account {storage} linked to Data Lake Analytics account {account} in {rg}, subscription {sub}.
        slots:
          container: path.containerName
          storage: path.storageAccountName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show container {container} of linked storage account {storage}.
        slots:
          container: path.containerName
          storage: path.storageAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}/storageAccounts/{storageAccountName}/containers/{containerName}/listSasTokens'].post
  update:
    x-apievangelist-phrasing:
      intent: Get SAS tokens for a linked storage container
      effect: read
      questions:
      - How do I get the SAS token Data Lake Analytics uses for a storage container?
      - Which shared access signature is tied to a container in a linked storage account?
      instructions:
      - text: List SAS tokens for container {container} in storage account {storage} on Data Lake Analytics account {account}, group {rg}, subscription {sub}.
        slots:
          container: path.containerName
          storage: path.storageAccountName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Fetch the Data Lake Analytics SAS token for container {container} in {storage}.
        slots:
          container: path.containerName
          storage: path.storageAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Storage/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a storage account name is available
      effect: read
      questions:
      - Is the storage account name I want already taken in Azure?
      - Can I validate a storage account name before creating the account?
      instructions:
      - text: Check whether storage account name {name} of type {type} is available in subscription {sub}.
        slots:
          name: requestBody.name
          type: requestBody.type
          sub: path.subscriptionId
      - text: Tell me if {name} is a valid, unused storage account name ({type}).
        slots:
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storage account's properties
      effect: read
      questions:
      - What SKU, location and status does my Azure storage account have?
      - Can I view a storage account's properties without its access keys?
      instructions:
      - text: Get the properties of storage account {account} in resource group {rg}, subscription {sub}.
        slots:
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the SKU, location and account status of storage account {account}.
        slots:
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a storage account
      effect: write
      questions:
      - How do I create a new Azure storage account with a chosen SKU and kind?
      - What happens if I send a create request for a storage account that already exists?
      instructions:
      - text: Create storage account {account} in resource group {rg}, subscription {sub} with SKU {sku}, kind {kind} in {location}.
        slots:
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          sku: requestBody.sku
          kind: requestBody.kind
          location: requestBody.location
      - text: Provision a new {kind} storage account {account} in {location} tagged {tags}.
        slots:
          kind: requestBody.kind
          account: path.accountName
          location: requestBody.location
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a storage account
      effect: destructive
      questions:
      - Can I permanently delete an Azure storage account?
      - What do I need to remove a storage account from a resource group?
      instructions:
      - text: Delete storage account {account} from resource group {rg} in subscription {sub}.
        slots:
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the Azure storage account named {account}.
        slots:
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a storage account's SKU, tier or tags
      effect: write
      questions:
      - How do I change the access tier or encryption on an existing storage account?
      - Can I map a custom domain to my storage account after it is created?
      instructions:
      - text: Update storage account {account} in resource group {rg}, subscription {sub} to SKU {sku}.
        slots:
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          sku: requestBody.sku
      - text: Change the tags on existing storage account {account} to {tags}.
        slots:
          account: path.accountName
          tags: requestBody.tags
      - text: Set access tier, encryption or custom domain on storage account {account} using {props}.
        slots:
          account: path.accountName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Storage/storageAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage accounts in a subscription
      effect: read
      questions:
      - Which storage accounts exist across my whole Azure subscription?
      - Does listing all storage accounts in a subscription return their keys?
      instructions:
      - text: List every storage account in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show all storage accounts I have across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage accounts in a resource group
      effect: read
      questions:
      - What storage accounts are in one of my resource groups?
      - Can I narrow the storage account list to a single resource group?
      instructions:
      - text: List the storage accounts in resource group {rg}, subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show storage accounts that belong to resource group {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: List a storage account's access keys
      effect: read
      questions:
      - How do I retrieve the access keys for my storage account?
      - Where can I find key1 and key2 for an Azure storage account?
      instructions:
      - text: List the access keys for storage account {account} in resource group {rg}, subscription {sub}.
        slots:
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Get the storage keys of account {account}.
        slots:
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/regenerateKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a storage account access key
      effect: destructive
      questions:
      - Can I regenerate one of my storage account's access keys if it leaked?
      - Which key name do I pass to rotate a storage account key?
      instructions:
      - text: Regenerate access key {key} for storage account {account} in resource group {rg}, subscription {sub}.
        slots:
          key: requestBody.keyName
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Rotate {key} on storage account {account}.
        slots:
          key: requestBody.keyName
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/ListAccountSas'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate an account SAS for a storage account
      effect: read
      questions:
      - How do I get an account-level shared access signature for my storage account?
      - Can I restrict an account SAS to certain services, permissions and an expiry time?
      instructions:
      - text: 'Make an account SAS for {account} ({rg}, {sub}): services {services}, types {types}, permissions {perm}, expiry {expiry}.'
        slots:
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          services: requestBody.signedServices
          types: requestBody.signedResourceTypes
          perm: requestBody.signedPermission
          expiry: requestBody.signedExpiry
      - text: Create account SAS credentials on {account} valid until {expiry} for IP {ip}.
        slots:
          account: path.accountName
          expiry: requestBody.signedExpiry
          ip: requestBody.signedIp
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/ListServiceSas'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a service SAS for a storage resource
      effect: read
      questions:
      - How do I create a service SAS scoped to one blob, container, table or queue?
      - Can a service SAS be limited to a partition key or row key range?
      instructions:
      - text: Generate a service SAS on storage account {account} in {rg}, subscription {sub} for resource {resource} of type {kind}.
        slots:
          account: path.accountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          resource: requestBody.canonicalizedResource
          kind: requestBody.signedResource
      - text: Create a service SAS for {resource} on {account} with permissions {perm} expiring {expiry}.
        slots:
          resource: requestBody.canonicalizedResource
          account: path.accountName
          perm: requestBody.signedPermission
          expiry: requestBody.signedExpiry
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Storage.Admin/locations/{location}/storageAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage accounts as an Azure Stack admin
      effect: read
      questions:
      - As a storage administrator, which tenant storage accounts exist in a location?
      - Can the admin storage account list be filtered or returned as a summary?
      instructions:
      - text: List storage accounts in admin location {location} matching filter {filter}.
        slots:
          location: path.location
          filter: query.$filter
      - text: Show an admin summary of all tenant storage accounts at this location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Storage.Admin/locations/{location}/storageAccounts/{accountId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant storage account as an admin
      effect: read
      questions:
      - As an operator, what are the details of one tenant storage account by id?
      - Can an admin look up a storage account by its internal account id?
      instructions:
      - text: Get the admin record for storage account id {id} in location {location}.
        slots:
          id: path.accountId
          location: path.location
      - text: Show operator details of tenant storage account {id}.
        slots:
          id: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Storage.Admin/locations/{location}/storageAccounts/{accountId}/undelete'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a deleted storage account
      effect: write
      questions:
      - Can I recover a storage account that was deleted?
      - Is it possible to undelete a storage account under a different name?
      instructions:
      - text: Undelete storage account {id} in admin location {location}.
        slots:
          id: path.accountId
          location: path.location
      - text: Restore deleted storage account {id} under the new name {name}.
        slots:
          id: path.accountId
          name: query.newAccountName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Storage.Admin/locations/{location}/reclaimStorageCapacity'].post
  update:
    x-apievangelist-phrasing:
      intent: Reclaim capacity from deleted storage objects
      effect: destructive
      questions:
      - How do I free up capacity held by deleted storage accounts and objects?
      - Is there an admin action to start reclaiming storage space right away?
      instructions:
      - text: Start reclaiming storage capacity from deleted storage objects in location {location}.
        slots:
          location: path.location
      - text: Kick off garbage collection of deleted storage accounts to recover disk space.
      method: generated
      generated: '2026-10-01'