# 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 Microsoft NetApp NetApp Accounts API
  version: 1.0.0
extends: openapi/microsoft-azure-netapp-accounts-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/netAppAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List NetApp accounts in a subscription
      effect: read
      questions:
      - Which Azure NetApp Files accounts do I have across my whole subscription?
      - Can I describe every NetApp account in the subscription at once?
      instructions:
      - text: List all NetApp accounts in my subscription.
      - text: Describe every Azure NetApp Files account across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List NetApp accounts in a resource group
      effect: read
      questions:
      - What NetApp accounts live in my current resource group?
      - Can I narrow the Azure NetApp Files account list to one resource group?
      instructions:
      - text: List the NetApp accounts in this resource group.
      - text: Describe Azure NetApp Files accounts scoped to the resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a NetApp account
      effect: read
      questions:
      - What are the settings of one of my Azure NetApp Files accounts?
      - Can I look up a NetApp account's encryption and identity configuration?
      instructions:
      - text: Get NetApp account {account}.
        slots:
          account: path.accountName
      - text: Show the configuration of Azure NetApp Files account {account}.
        slots:
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a NetApp account
      effect: write
      questions:
      - How do I create a new Azure NetApp Files account?
      - Can I set a managed identity when creating a NetApp account?
      instructions:
      - text: Create NetApp account {account}.
        slots:
          account: path.accountName
      - text: Create or replace NetApp account {account} with identity {identity}.
        slots:
          account: path.accountName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a NetApp account
      effect: destructive
      questions:
      - Can I delete an Azure NetApp Files account I no longer use?
      - What is removed when a NetApp account is deleted?
      instructions:
      - text: Delete NetApp account {account}.
        slots:
          account: path.accountName
      - text: Remove Azure NetApp Files account {account} permanently.
        slots:
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a NetApp account
      effect: write
      questions:
      - Can I change tags or properties on an existing NetApp account without replacing it?
      - Which NetApp account fields can be patched?
      instructions:
      - text: Update tags on NetApp account {account} to {tags}.
        slots:
          account: path.accountName
          tags: requestBody.tags
      - text: Patch NetApp account {account} with properties {properties}.
        slots:
          account: path.accountName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/renewCredentials'].post
  update:
    x-apievangelist-phrasing:
      intent: Renew a NetApp account's identity credentials
      effect: write
      questions:
      - How do I renew the credentials NetApp uses to reach Key Vault for customer-managed keys?
      - Why would I need to renew identity credentials on a NetApp account?
      instructions:
      - text: Renew the identity credentials for NetApp account {account}.
        slots:
          account: path.accountName
      - text: Refresh the Key Vault authentication credentials of account {account}.
        slots:
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/migrateEncryption'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate volumes' encryption key source
      effect: write
      questions:
      - Can I move all volumes in a VNet to a different encryption key source?
      - What happens if the volumes I migrate share an encryption sibling set with another account?
      instructions:
      - text: Migrate volume encryption for NetApp account {account} in virtual network {vnet} using private endpoint {endpoint}.
        slots:
          account: path.accountName
          vnet: requestBody.virtualNetworkId
          endpoint: requestBody.privateEndpointId
      - text: Switch volumes of account {account} in VNet {vnet} to the key source reachable via {endpoint}.
        slots:
          account: path.accountName
          vnet: requestBody.virtualNetworkId
          endpoint: requestBody.privateEndpointId
      method: generated
      generated: '2026-09-26'