# 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 RecoveryServicesBackupClient Protection…
  version: 1.0.0
extends: openapi/microsoft-azure-protection-policies-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/{policyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backup policy in a Recovery Services vault
      effect: read
      questions:
      - What schedule and retention does one of my vault's backup policies use?
      - How do I look up a backup policy by name in a Recovery Services vault?
      instructions:
      - text: Get backup policy {policyName} in vault {vaultName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the retention settings of backup policy {policyName}.
        slots:
          policyName: path.policyName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/{policyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or modify a backup policy
      effect: write
      questions:
      - Can I create a new backup policy with its own schedule in my Recovery Services vault?
      - Is changing a backup policy applied immediately or as a long-running operation?
      instructions:
      - text: Create backup policy {policyName} in vault {vaultName}, resource group {resourceGroupName}, subscription {subscriptionId}, with {properties}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Change the schedule on backup policy {policyName} to {properties}.
        slots:
          policyName: path.policyName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/{policyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a backup policy from a vault
      effect: destructive
      questions:
      - How do I remove a backup policy from a Recovery Services vault?
      - Can I check the status of a backup policy deletion afterwards?
      instructions:
      - text: Delete backup policy {policyName} from vault {vaultName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove backup policy {policyName} from vault {vaultName}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
      method: generated
      generated: '2026-10-01'