# 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 Point API
  version: 1.0.0
extends: openapi/microsoft-azure-recoverypoint-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.DataReplication/replicationVaults/{vaultName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a replication recovery point
      effect: read
      questions:
      - What are the details of one recovery point for a replicated protected item?
      - Can I inspect a Data Replication recovery point by name?
      instructions:
      - text: Get recovery point {recoveryPointName} of replicated item {protectedItemName} in replication vault {vaultName}.
        slots:
          recoveryPointName: path.recoveryPointName
          protectedItemName: path.protectedItemName
          vaultName: path.vaultName
      - text: Show replication recovery point {recoveryPointName} for protected item {protectedItemName} in {vaultName}.
        slots:
          recoveryPointName: path.recoveryPointName
          protectedItemName: path.protectedItemName
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/protectedItems/{protectedItemName}/recoveryPoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List recovery points of a replicated item
      effect: read
      questions:
      - Which recovery points exist for a protected item in my replication vault?
      - How far back can I fail over a replicated machine?
      instructions:
      - text: List recovery points of replicated item {protectedItemName} in replication vault {vaultName}.
        slots:
          protectedItemName: path.protectedItemName
          vaultName: path.vaultName
      - text: Show failover points available for protected item {protectedItemName} in {vaultName}.
        slots:
          protectedItemName: path.protectedItemName
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/recoveryPoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List recovery points of a backup instance
      effect: read
      questions:
      - What restore points exist for a backup instance in my backup vault?
      - Can I filter a backup instance's recovery points by date?
      instructions:
      - text: List recovery points for backup instance {backupInstanceName} in backup vault {vaultName}.
        slots:
          backupInstanceName: path.backupInstanceName
          vaultName: path.vaultName
      - text: Show restore points of {backupInstanceName} in {vaultName} matching {filter}.
        slots:
          backupInstanceName: path.backupInstanceName
          vaultName: path.vaultName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/recoveryPoints/{recoveryPointId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backup instance recovery point
      effect: read
      questions:
      - What's in a specific restore point for my backup instance?
      - Can I fetch a backup recovery point by its recoveryPointId?
      instructions:
      - text: Get recovery point {recoveryPointId} of backup instance {backupInstanceName} in backup vault {vaultName}.
        slots:
          recoveryPointId: path.recoveryPointId
          backupInstanceName: path.backupInstanceName
          vaultName: path.vaultName
      - text: Show restore point {recoveryPointId} for {backupInstanceName} in {vaultName}.
        slots:
          recoveryPointId: path.recoveryPointId
          backupInstanceName: path.backupInstanceName
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}/move'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a recovery point to another storage tier
      effect: write
      questions:
      - Can I move an old recovery point to archive tier to save cost?
      - How do I shift a Recovery Services recovery point between datastore tiers?
      instructions:
      - text: Move point {recoveryPointId} of {protectedItemName} ({containerName}, {fabricName}) in vault {vaultName}, group {resourceGroupName}, to {targetTierType}.
        slots:
          recoveryPointId: path.recoveryPointId
          protectedItemName: path.protectedItemName
          containerName: path.containerName
          fabricName: path.fabricName
          vaultName: path.vaultName
          resourceGroupName: path.resourceGroupName
          targetTierType: requestBody.targetTierType
      - text: Archive recovery point {recoveryPointId} for {protectedItemName} from {sourceTierType} to {targetTierType}.
        slots:
          recoveryPointId: path.recoveryPointId
          protectedItemName: path.protectedItemName
          sourceTierType: requestBody.sourceTierType
          targetTierType: requestBody.targetTierType
      - text: In subscription {subscriptionId}, tier recovery point {recoveryPointId} of item {protectedItemName} down to {targetTierType}.
        slots:
          subscriptionId: path.subscriptionId
          recoveryPointId: path.recoveryPointId
          protectedItemName: path.protectedItemName
          targetTierType: requestBody.targetTierType
      method: generated
      generated: '2026-09-26'