# 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 Azure Site Recovery Management Service…
  version: 1.0.0
extends: openapi/microsoft-azure-protecteditem-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/protectedItems/{protectedItemName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a replication protected item
      effect: read
      questions:
      - How do I check the replication health of one protected item in my vault?
      - What details does a protected item in a replication vault show?
      instructions:
      - text: Get protected item {item} in replication vault {vault}.
        slots:
          item: path.protectedItemName
          vault: path.vaultName
      - text: Show the replication status of {item}.
        slots:
          item: path.protectedItemName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/protectedItems/{protectedItemName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Protect an item for replication
      effect: write
      questions:
      - How do I start replicating a machine into an Azure replication vault?
      - Can I create a new protected item for disaster recovery?
      instructions:
      - text: Create protected item {item} in vault {vault} with properties {properties}.
        slots:
          item: path.protectedItemName
          vault: path.vaultName
          properties: requestBody.properties
      - text: Enable replication for {item} in {vault}.
        slots:
          item: path.protectedItemName
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/protectedItems/{protectedItemName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a replication protected item
      effect: destructive
      questions:
      - How do I stop protecting an item and remove it from the replication vault?
      - Can I force-delete a protected item that won't remove cleanly?
      instructions:
      - text: Remove protected item {item} from vault {vault}.
        slots:
          item: path.protectedItemName
          vault: path.vaultName
      - text: Force-delete {item} from {vault} with forceDelete {force}.
        slots:
          item: path.protectedItemName
          vault: path.vaultName
          force: query.forceDelete
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/protectedItems'].get
  update:
    x-apievangelist-phrasing:
      intent: List protected items in a replication vault
      effect: read
      questions:
      - Which items are currently protected in my replication vault?
      - Can I see everything being replicated by one vault?
      instructions:
      - text: List the protected items in replication vault {vault}.
        slots:
          vault: path.vaultName
      - text: Show everything replicating in {vault}.
        slots:
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/protectedItems/{protectedItemName}/plannedFailover'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a planned failover on a protected item
      effect: write
      questions:
      - How do I perform a planned failover for a replicated machine?
      - Can I fail over one protected item on purpose during a maintenance window?
      instructions:
      - text: Perform a planned failover of {item} in vault {vault} with {properties}.
        slots:
          item: path.protectedItemName
          vault: path.vaultName
          properties: requestBody.properties
      - text: Fail over protected item {item} as planned.
        slots:
          item: path.protectedItemName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/protectedItems/{protectedItemName}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an async operation on a protected item
      effect: read
      questions:
      - How do I track whether a failover or other async job on a protected item finished?
      - Where can I see the status of an operation running against a protected item?
      instructions:
      - text: Check operation {operationId} status for protected item {item} in vault {vault}.
        slots:
          operationId: path.operationId
          item: path.protectedItemName
          vault: path.vaultName
      - text: Tell me if the async job on {item} has completed.
        slots:
          item: path.protectedItemName
      method: generated
      generated: '2026-10-01'