# 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 SiteRecoveryManagementClient Replication…
  version: 1.0.0
extends: openapi/microsoft-azure-replicationprotectioncontainermappings-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectionContainerMappings'].get
  update:
    x-apievangelist-phrasing:
      intent: List mappings for a protection container
      effect: read
      questions:
      - Which container mappings are set up for one protection container in Site Recovery?
      - Can I see the replication pairings of a single protection container?
      instructions:
      - text: List mappings for protection container {container} in fabric {fabric} of vault {vault}, resource group {rg}, subscription {sub}.
        slots:
          container: path.protectionContainerName
          fabric: path.fabricName
          vault: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the pairings configured for container {container} in fabric {fabric}.
        slots:
          container: path.protectionContainerName
          fabric: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectionContainerMappings/{mappingName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a protection container mapping
      effect: read
      questions:
      - What are the details of one protection container mapping?
      - Can I check the replication policy and target of a specific container mapping?
      instructions:
      - text: Get mapping {mapping} of container {container} in fabric {fabric}, vault {vault}, resource group {rg}, subscription {sub}.
        slots:
          mapping: path.mappingName
          container: path.protectionContainerName
          fabric: path.fabricName
          vault: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show container mapping {mapping} on {container}.
        slots:
          mapping: path.mappingName
          container: path.protectionContainerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectionContainerMappings/{mappingName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a protection container mapping
      effect: write
      questions:
      - How do I pair a protection container with a recovery container for replication?
      - Can I create a new container mapping in my Recovery Services vault?
      instructions:
      - text: Create mapping {mapping} for container {container} in fabric {fabric} of vault {vault} ({rg}, subscription {sub}) with {properties}.
        slots:
          mapping: path.mappingName
          container: path.protectionContainerName
          fabric: path.fabricName
          vault: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Pair container {container} using new mapping {mapping}.
        slots:
          container: path.protectionContainerName
          mapping: path.mappingName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectionContainerMappings/{mappingName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Force-delete a protection container mapping
      effect: destructive
      questions:
      - How do I force delete a protection container mapping that won't remove cleanly?
      - Can I purge a container mapping outright?
      instructions:
      - text: Purge mapping {mapping} of container {container} in fabric {fabric}, vault {vault}, resource group {rg}, subscription {sub}.
        slots:
          mapping: path.mappingName
          container: path.protectionContainerName
          fabric: path.fabricName
          vault: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Force-delete container mapping {mapping} on {container}.
        slots:
          mapping: path.mappingName
          container: path.protectionContainerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectionContainerMappings/{mappingName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a protection container mapping
      effect: write
      questions:
      - Can I change the settings of an existing protection container mapping?
      - What's the way to modify a container mapping without recreating it?
      instructions:
      - text: Update mapping {mapping} of container {container} in fabric {fabric}, vault {vault} ({rg}, subscription {sub}) with {properties}.
        slots:
          mapping: path.mappingName
          container: path.protectionContainerName
          fabric: path.fabricName
          vault: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Modify the settings on existing container mapping {mapping}.
        slots:
          mapping: path.mappingName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectionContainerMappings/{mappingName}/remove'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a protection container mapping
      effect: destructive
      questions:
      - How do I cleanly remove a protection container mapping through the remove action?
      - Can I unpair two protection containers gracefully rather than purging?
      instructions:
      - text: Remove mapping {mapping} from container {container} in fabric {fabric}, vault {vault}, resource group {rg}, subscription {sub}.
        slots:
          mapping: path.mappingName
          container: path.protectionContainerName
          fabric: path.fabricName
          vault: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Gracefully unpair container {container} by removing mapping {mapping}.
        slots:
          container: path.protectionContainerName
          mapping: path.mappingName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationProtectionContainerMappings'].get
  update:
    x-apievangelist-phrasing:
      intent: List all protection container mappings in a vault
      effect: read
      questions:
      - What container mappings exist across my whole Recovery Services vault?
      - Can I list every replication pairing in a vault regardless of fabric?
      instructions:
      - text: List all protection container mappings in vault {vault}, resource group {rg}, subscription {sub}.
        slots:
          vault: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every vault-wide container mapping in {vault}.
        slots:
          vault: path.resourceName
      method: generated
      generated: '2026-09-26'