# 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 Protected…
  version: 1.0.0
extends: openapi/microsoft-azure-protecteditems-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backed-up item's details
      effect: read
      questions:
      - What is the backup status of a specific protected item in my vault?
      - Can I see which backup policy an item is using?
      instructions:
      - text: Get protected item {item} in container {container} of vault {vault}.
        slots:
          item: path.protectedItemName
          container: path.containerName
          vault: path.vaultName
      - text: Show backup details for {item} in fabric {fabric}, container {container}, resource group {rg}, subscription {sub}.
        slots:
          item: path.protectedItemName
          fabric: path.fabricName
          container: path.containerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable backup or change an item's policy
      effect: write
      questions:
      - How do I turn on backup for a VM in my Recovery Services vault?
      - Can I switch an already backed up item to a different policy?
      instructions:
      - text: Enable backup of {item} in container {container} of vault {vault}.
        slots:
          item: path.protectedItemName
          container: path.containerName
          vault: path.vaultName
      - text: Update backup policy for {item} in fabric {fabric}, container {container}, resource group {rg}, subscription {sub}.
        slots:
          item: path.protectedItemName
          fabric: path.fabricName
          container: path.containerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Stop backing up an item
      effect: destructive
      questions:
      - How do I disable backup for an item in my vault?
      - What happens when I stop protection on a backed up item?
      instructions:
      - text: Disable backup of {item} in container {container} of vault {vault}.
        slots:
          item: path.protectedItemName
          container: path.containerName
          vault: path.vaultName
      - text: Stop protecting {item} in fabric {fabric}, container {container}, resource group {rg}, subscription {sub}.
        slots:
          item: path.protectedItemName
          fabric: path.fabricName
          container: path.containerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'