# 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 Recovery Points API
  version: 1.0.0
extends: openapi/microsoft-azure-recovery-points-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List backup recovery points of a protected item
      effect: read
      questions:
      - What backup copies exist for a protected item in my Recovery Services vault?
      - Can I filter a protected item's backup recovery points by date?
      instructions:
      - text: List recovery points for protected item {protectedItemName} in container {containerName}, fabric {fabricName}, vault {vaultName}.
        slots:
          protectedItemName: path.protectedItemName
          containerName: path.containerName
          fabricName: path.fabricName
          vaultName: path.vaultName
      - text: Show backup copies of {protectedItemName} in vault {vaultName} matching {filter}.
        slots:
          protectedItemName: path.protectedItemName
          vaultName: path.vaultName
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backup recovery point
      effect: read
      questions:
      - How do I get details of one backup copy of a protected item?
      - Is looking up a backup recovery point asynchronous?
      instructions:
      - text: Get backup recovery point {point} of {item} in container {container}, fabric {fabric}, vault {vault}.
        slots:
          point: path.recoveryPointId
          item: path.protectedItemName
          container: path.containerName
          fabric: path.fabricName
          vault: path.vaultName
      - text: Show backup copy {point} for backed-up item {item} in resource group {rg}, subscription {sub}.
        slots:
          point: path.recoveryPointId
          item: path.protectedItemName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectedItems/{replicatedProtectedItemName}/recoveryPoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List Site Recovery points for a replicated item
      effect: read
      questions:
      - Which recovery points can I fail over to for a replicated machine in Site Recovery?
      - How do I see available replication recovery points before a failover?
      instructions:
      - text: List replication recovery points for {item} in protection container {container}, fabric {fabric}, vault {vault}.
        slots:
          item: path.replicatedProtectedItemName
          container: path.protectionContainerName
          fabric: path.fabricName
          vault: path.resourceName
      - text: Show failover points for replicated machine {item} in resource group {rg}, subscription {sub}.
        slots:
          item: path.replicatedProtectedItemName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectedItems/{replicatedProtectedItemName}/recoveryPoints/{recoveryPointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Site Recovery point of a replicated item
      effect: read
      questions:
      - What's in a specific Site Recovery point for my replicated machine?
      - Can I look up one replication recovery point by name?
      instructions:
      - text: Get Site Recovery point {recoveryPointName} of replicated item {replicatedProtectedItemName} in vault {resourceName}.
        slots:
          recoveryPointName: path.recoveryPointName
          replicatedProtectedItemName: path.replicatedProtectedItemName
          resourceName: path.resourceName
      - text: Show replication recovery point {recoveryPointName} in container {protectionContainerName}, fabric {fabricName}.
        slots:
          recoveryPointName: path.recoveryPointName
          protectionContainerName: path.protectionContainerName
          fabricName: path.fabricName
      method: generated
      generated: '2026-10-01'