# 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 Backup Policies API
  version: 1.0.0
extends: openapi/microsoft-azure-backup-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List policies in a Data Protection backup vault
      effect: read
      questions:
      - Which backup policies are defined in my Data Protection backup vault?
      - How do I see all policies attached to a backup vault?
      instructions:
      - text: List backup policies in backup vault {vaultName}.
        slots:
          vaultName: path.vaultName
      - text: Enumerate all Data Protection policies configured in vault {vaultName}.
        slots:
          vaultName: path.vaultName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{backupPolicyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Data Protection backup policy
      effect: read
      questions:
      - What schedule and retention does a backup vault policy define?
      - Can I read a single policy from a Data Protection backup vault?
      instructions:
      - text: Get backup policy {backupPolicyName} from backup vault {vaultName}.
        slots:
          backupPolicyName: path.backupPolicyName
          vaultName: path.vaultName
      - text: Show Data Protection policy {backupPolicyName} in vault {vaultName}.
        slots:
          backupPolicyName: path.backupPolicyName
          vaultName: path.vaultName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{backupPolicyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a backup vault policy
      effect: write
      questions:
      - How do I add a new backup policy to a Data Protection backup vault?
      - Can I overwrite an existing backup vault policy with new properties?
      instructions:
      - text: Create backup policy {backupPolicyName} in backup vault {vaultName}.
        slots:
          backupPolicyName: path.backupPolicyName
          vaultName: path.vaultName
      - text: Replace Data Protection policy {backupPolicyName} in vault {vaultName} with properties {properties}.
        slots:
          backupPolicyName: path.backupPolicyName
          vaultName: path.vaultName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{backupPolicyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a backup vault policy
      effect: destructive
      questions:
      - Can I delete a policy from my Data Protection backup vault?
      - How do I get rid of a backup vault policy I no longer use?
      instructions:
      - text: Delete backup policy {backupPolicyName} from backup vault {vaultName}.
        slots:
          backupPolicyName: path.backupPolicyName
          vaultName: path.vaultName
      - text: Remove Data Protection policy {backupPolicyName} in vault {vaultName}.
        slots:
          backupPolicyName: path.backupPolicyName
          vaultName: path.vaultName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List Recovery Services vault backup policies
      effect: read
      questions:
      - Which backup policies are associated with my Recovery Services vault?
      - Can I filter Recovery Services policies by workload or management type?
      instructions:
      - text: List backup policies in Recovery Services vault {vaultName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show Recovery Services vault {vaultName} policies matching {filter} in group {resourceGroupName}.
        slots:
          vaultName: path.vaultName
          filter: query.$filter
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backupPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List StorSimple device backup policies
      effect: read
      questions:
      - Which backup policies are configured on a StorSimple device?
      - How do I see all device-level backup policies under a StorSimple manager?
      instructions:
      - text: List backup policies on StorSimple device {deviceName} under manager {managerName}.
        slots:
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Show device {deviceName} policies for manager {managerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backupPolicies/{backupPolicyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple device backup policy
      effect: read
      questions:
      - What volumes and schedules does a StorSimple backup policy cover?
      - Can I read one backup policy on a StorSimple device?
      instructions:
      - text: Get backup policy {backupPolicyName} on StorSimple device {deviceName}, manager {managerName}.
        slots:
          backupPolicyName: path.backupPolicyName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Show StorSimple policy {backupPolicyName} (device {deviceName}, group {resourceGroupName}, subscription {subscriptionId}).
        slots:
          backupPolicyName: path.backupPolicyName
          deviceName: path.deviceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backupPolicies/{backupPolicyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a StorSimple backup policy
      effect: write
      questions:
      - How do I set up a backup policy on a StorSimple device?
      - Can I change which volumes a StorSimple backup policy protects?
      instructions:
      - text: Create backup policy {backupPolicyName} on StorSimple device {deviceName} under manager {managerName}.
        slots:
          backupPolicyName: path.backupPolicyName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Update StorSimple policy {backupPolicyName} with {properties} (group {resourceGroupName}, subscription {subscriptionId}).
        slots:
          backupPolicyName: path.backupPolicyName
          properties: requestBody.properties
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backupPolicies/{backupPolicyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a StorSimple backup policy
      effect: destructive
      questions:
      - Can I remove a backup policy from a StorSimple device?
      - What happens to scheduled backups when I delete a StorSimple policy?
      instructions:
      - text: Delete backup policy {backupPolicyName} from StorSimple device {deviceName}, manager {managerName}.
        slots:
          backupPolicyName: path.backupPolicyName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Remove StorSimple policy {backupPolicyName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          backupPolicyName: path.backupPolicyName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/backupPolicies/{backupPolicyName}/backup'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a StorSimple backup policy now
      effect: write
      questions:
      - How do I trigger an on-demand backup from a StorSimple policy?
      - Can I choose a local snapshot or cloud snapshot for an immediate backup?
      instructions:
      - text: Run backup policy {backupPolicyName} on device {deviceName} now as a {backupType}.
        slots:
          backupPolicyName: path.backupPolicyName
          deviceName: path.deviceName
          backupType: query.backupType
      - text: Back up now with {backupType} for policy {backupPolicyName}, manager {managerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          backupType: query.backupType
          backupPolicyName: path.backupPolicyName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'