# 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-replicationprotectioncontainers-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'].get
  update:
    x-apievangelist-phrasing:
      intent: List protection containers in a replication fabric
      effect: read
      questions:
      - Which protection containers exist in a Site Recovery fabric?
      - What containers are under one replication fabric in my vault?
      instructions:
      - text: List protection containers in fabric {fabricName} of vault {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          fabricName: path.fabricName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show replication protection containers for fabric {fabricName}.
        slots:
          fabricName: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Site Recovery protection container
      effect: read
      questions:
      - How do I see the details of one replication protection container?
      - What pairing status does a protection container show?
      instructions:
      - text: Get protection container {protectionContainerName} in fabric {fabricName} of vault {resourceName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show replication container {protectionContainerName} details.
        slots:
          protectionContainerName: path.protectionContainerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Site Recovery protection container
      effect: write
      questions:
      - How do I create a protection container in a replication fabric?
      - Can I set provider-specific input when creating a protection container?
      instructions:
      - text: Create protection container {protectionContainerName} in fabric {fabricName} of vault {resourceName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Create replication container {protectionContainerName} with properties {properties}.
        slots:
          protectionContainerName: path.protectionContainerName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/discoverProtectableItem'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a physical server to a protection container
      effect: write
      questions:
      - How do I add a physical server as a protectable item in Site Recovery?
      - Can I register a machine by IP for discovery in a protection container?
      instructions:
      - text: Discover protectable item in container {protectionContainerName} in fabric {fabricName}, vault {resourceName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Add physical server {properties} to protection container {protectionContainerName}.
        slots:
          properties: requestBody.properties
          protectionContainerName: path.protectionContainerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/remove'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a Site Recovery protection container
      effect: destructive
      questions:
      - How do I remove a protection container from a replication fabric?
      - Can I delete a protection container I no longer use for replication?
      instructions:
      - text: Remove protection container {protectionContainerName} from fabric {fabricName} in vault {resourceName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Delete replication container {protectionContainerName}.
        slots:
          protectionContainerName: path.protectionContainerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/switchprotection'].post
  update:
    x-apievangelist-phrasing:
      intent: Switch protection to another container or provider
      effect: write
      questions:
      - How do I move replication protection from one container to another?
      - Can I switch a protected item to a different replication provider?
      instructions:
      - text: Switch protection on container {protectionContainerName} in fabric {fabricName}, vault {resourceName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Switch protection for container {protectionContainerName} using {properties}.
        slots:
          protectionContainerName: path.protectionContainerName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationProtectionContainers'].get
  update:
    x-apievangelist-phrasing:
      intent: List all protection containers in a vault
      effect: read
      questions:
      - What protection containers exist across every fabric in my Recovery Services vault?
      - Can I see all replication containers in a vault at once?
      instructions:
      - text: List all protection containers in vault {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show every replication protection container in vault {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'