# 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-protectioncontainers-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.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backup protection container
      effect: read
      questions:
      - How do I see a container registered to my Recovery Services vault?
      - What details does a backup protection container show?
      instructions:
      - text: Get protection container {containerName} in fabric {fabricName} of vault {vaultName}.
        slots:
          containerName: path.containerName
          fabricName: path.fabricName
          vaultName: path.vaultName
      - text: Show backup container {containerName} registered to vault {vaultName}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
      - text: Fetch container {containerName} in fabric {fabricName}, vault {vaultName}, {resourceGroupName}, subscription {subscriptionId}.
        slots:
          containerName: path.containerName
          fabricName: path.fabricName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Register a container with a Recovery Services vault
      effect: write
      questions:
      - Can I register a container, like a storage account or SQL VM, with my backup vault?
      - How do I track the status after registering a protection container?
      instructions:
      - text: Register container {containerName} with vault {vaultName} in fabric {fabricName}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
          fabricName: path.fabricName
      - text: Register protection container {containerName} in vault {vaultName} with properties {properties}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
          properties: requestBody.properties
      - text: Register container {containerName} in vault {vaultName} ({resourceGroupName}, subscription {subscriptionId}), fabric {fabricName}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          fabricName: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unregister a container from a Recovery Services vault
      effect: destructive
      questions:
      - How do I unregister a container from my Recovery Services vault?
      - Is unregistering a backup container an asynchronous operation?
      instructions:
      - text: Unregister container {containerName} from vault {vaultName} in fabric {fabricName}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
          fabricName: path.fabricName
      - text: Remove protection container {containerName} from vault {vaultName}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
      - text: Unregister container {containerName} from vault {vaultName} ({resourceGroupName}, subscription {subscriptionId}), fabric {fabricName}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          fabricName: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/inquire'].post
  update:
    x-apievangelist-phrasing:
      intent: Inquire protectable items in a container
      effect: write
      questions:
      - How do I discover the protectable items, like databases, inside a registered container?
      - Can I filter the inquiry of protectable items in a container?
      instructions:
      - text: Inquire protectable items in container {containerName} of vault {vaultName} in fabric {fabricName}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
          fabricName: path.fabricName
      - text: Inquire items in container {containerName} of vault {vaultName} matching {filter}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
          filter: query.$filter
      - text: Inquire container {containerName} in vault {vaultName} ({resourceGroupName}, subscription {subscriptionId}), fabric {fabricName}.
        slots:
          containerName: path.containerName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          fabricName: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/refreshContainers'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh discoverable backup containers
      effect: write
      questions:
      - How do I discover new containers in my subscription that can be backed up?
      - Which call refreshes the list of containers a Recovery Services vault can protect?
      instructions:
      - text: Refresh containers for vault {vaultName} in fabric {fabricName}.
        slots:
          vaultName: path.vaultName
          fabricName: path.fabricName
      - text: Rediscover backup containers in fabric {fabricName} of vault {vaultName} using filter {filter}.
        slots:
          fabricName: path.fabricName
          vaultName: path.vaultName
          filter: query.$filter
      - text: Refresh containers in fabric {fabricName} of vault {vaultName} ({resourceGroupName}, subscription {subscriptionId}).
        slots:
          fabricName: path.fabricName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'