# 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 Backup Policy API
  version: 1.0.0
extends: openapi/microsoft-azure-backup-policy-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List backup policies in a NetApp account
      effect: read
      questions:
      - Which backup policies are defined in my Azure NetApp Files account?
      - Can I see every NetApp backup policy in one account at once?
      instructions:
      - text: List backup policies in NetApp account {accountName}, resource group {resourceGroupName}.
        slots:
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: Show all the volume backup policies set up under NetApp account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupPolicies/{backupPolicyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a NetApp backup policy
      effect: read
      questions:
      - What retention does a particular NetApp backup policy keep?
      - Can I read one backup policy from my NetApp account by name?
      instructions:
      - text: Get backup policy {backupPolicyName} in NetApp account {accountName}.
        slots:
          backupPolicyName: path.backupPolicyName
          accountName: path.accountName
      - text: Show the settings of NetApp policy {backupPolicyName} in group {resourceGroupName}.
        slots:
          backupPolicyName: path.backupPolicyName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupPolicies/{backupPolicyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a NetApp backup policy
      effect: write
      questions:
      - How do I set up a new backup policy for my Azure NetApp Files volumes?
      - Can I define daily, weekly and monthly backup retention in a new NetApp policy?
      instructions:
      - text: Create backup policy {policy} on NetApp account {account}.
        slots:
          policy: path.backupPolicyName
          account: path.accountName
      - text: Add a new backup policy named {policy} with properties {properties}.
        slots:
          policy: path.backupPolicyName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupPolicies/{backupPolicyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a NetApp backup policy
      effect: destructive
      questions:
      - Can I remove a backup policy from my NetApp account?
      - Which call permanently deletes an Azure NetApp Files backup policy?
      instructions:
      - text: Delete backup policy {backupPolicyName} from NetApp account {accountName}.
        slots:
          backupPolicyName: path.backupPolicyName
          accountName: path.accountName
      - text: Permanently remove NetApp policy {backupPolicyName} in group {resourceGroupName}.
        slots:
          backupPolicyName: path.backupPolicyName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupPolicies/{backupPolicyName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing NetApp backup policy
      effect: write
      questions:
      - Can I change the retention counts on a backup policy that already exists?
      - How do I disable an existing NetApp backup policy without deleting it?
      instructions:
      - text: Patch backup policy {policy} on account {account} with {properties}.
        slots:
          policy: path.backupPolicyName
          account: path.accountName
          properties: requestBody.properties
      - text: Update the tags on existing backup policy {policy} to {tags}.
        slots:
          policy: path.backupPolicyName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'