# 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 Snapshot Policy API
  version: 1.0.0
extends: openapi/microsoft-azure-snapshot-policy-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List snapshot policies in a NetApp account
      effect: read
      questions:
      - Which snapshot policies are defined in my Azure NetApp Files account?
      - How do I see all automatic snapshot schedules for a NetApp account?
      instructions:
      - text: List snapshot policies in NetApp account {accountName}.
        slots:
          accountName: path.accountName
      - text: Show every snapshot schedule configured on NetApp account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies/{snapshotPolicyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a NetApp snapshot policy
      effect: read
      questions:
      - How do I view the schedule of one snapshot policy?
      - What hourly, daily or weekly settings does a snapshot policy have?
      instructions:
      - text: Get snapshot policy {snapshotPolicyName} in NetApp account {accountName}.
        slots:
          snapshotPolicyName: path.snapshotPolicyName
          accountName: path.accountName
      - text: Show the schedule of snapshot policy {snapshotPolicyName}.
        slots:
          snapshotPolicyName: path.snapshotPolicyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies/{snapshotPolicyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a NetApp snapshot policy
      effect: write
      questions:
      - How do I set up automatic snapshots for my NetApp volumes?
      - What must I include when creating a snapshot policy?
      instructions:
      - text: Create snapshot policy {snapshotPolicyName} in NetApp account {accountName} with {properties}.
        slots:
          snapshotPolicyName: path.snapshotPolicyName
          accountName: path.accountName
          properties: requestBody.properties
      - text: Add a new snapshot schedule called {snapshotPolicyName} to account {accountName}.
        slots:
          snapshotPolicyName: path.snapshotPolicyName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies/{snapshotPolicyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a NetApp snapshot policy
      effect: destructive
      questions:
      - Can I delete a snapshot policy I no longer need?
      - How do I stop a snapshot schedule by removing its policy?
      instructions:
      - text: Delete snapshot policy {snapshotPolicyName} from NetApp account {accountName}.
        slots:
          snapshotPolicyName: path.snapshotPolicyName
          accountName: path.accountName
      - text: Remove the snapshot schedule {snapshotPolicyName}.
        slots:
          snapshotPolicyName: path.snapshotPolicyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies/{snapshotPolicyName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify an existing NetApp snapshot policy
      effect: write
      questions:
      - How do I change the schedule of a snapshot policy that already exists?
      - Can I patch the tags on a snapshot policy?
      instructions:
      - text: Patch snapshot policy {snapshotPolicyName} in NetApp account {accountName} with {properties}.
        slots:
          snapshotPolicyName: path.snapshotPolicyName
          accountName: path.accountName
          properties: requestBody.properties
      - text: Change the tags on existing snapshot policy {snapshotPolicyName} to {tags}.
        slots:
          snapshotPolicyName: path.snapshotPolicyName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'