# 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-replicationrecoveryplans-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: 12
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans'].get
  update:
    x-apievangelist-phrasing:
      intent: List recovery plans in a vault
      effect: read
      questions:
      - Which Site Recovery recovery plans are defined in my vault?
      - Can I see every recovery plan in a Recovery Services vault?
      instructions:
      - text: List the recovery plans in vault {vault} in resource group {resource_group}, subscription {subscription}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show all recovery plans configured in vault {vault}.
        slots:
          vault: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a recovery plan
      effect: read
      questions:
      - What groups and machines does a specific recovery plan contain?
      - Can I check the current state of one recovery plan?
      instructions:
      - text: Get recovery plan {plan} in vault {vault}, resource group {resource_group}, subscription {subscription}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
      - text: Show me the details of recovery plan {plan} in vault {vault}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a recovery plan
      effect: write
      questions:
      - How do I create a new disaster recovery plan in my vault?
      - What do I need to define when setting up a recovery plan?
      instructions:
      - text: Create recovery plan {plan} in vault {vault} (group {resource_group}, subscription {subscription}) with properties {properties}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
          properties: requestBody.properties
      - text: Set up a new recovery plan {plan} in vault {vault} using {properties}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a recovery plan
      effect: destructive
      questions:
      - Can I delete a recovery plan I no longer need?
      - What happens to protected machines when I remove their recovery plan?
      instructions:
      - text: Delete recovery plan {plan} from vault {vault} in group {resource_group}, subscription {subscription}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
      - text: Remove the recovery plan {plan} in vault {vault}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a recovery plan
      effect: write
      questions:
      - How do I change the groups or actions in an existing recovery plan?
      - Can I edit a recovery plan without recreating it?
      instructions:
      - text: Update recovery plan {plan} in vault {vault} (group {resource_group}, subscription {subscription}) with {properties}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
          properties: requestBody.properties
      - text: Modify the existing recovery plan {plan} in vault {vault} to use {properties}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}/failoverCancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a recovery plan failover
      effect: destructive
      questions:
      - Can I cancel a failover that is under way for a recovery plan?
      - How do I stop a recovery plan failover before it completes?
      instructions:
      - text: Cancel the failover of recovery plan {plan} in vault {vault}, group {resource_group}, subscription {subscription}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
      - text: Abort the running failover on recovery plan {plan} in vault {vault}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}/failoverCommit'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit a recovery plan failover
      effect: destructive
      questions:
      - How do I commit a failover once I'm happy with the recovered machines?
      - Is committing a recovery plan failover a final step?
      instructions:
      - text: Commit the failover of recovery plan {plan} in vault {vault}, group {resource_group}, subscription {subscription}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
      - text: Finalize the completed failover for recovery plan {plan} in vault {vault}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}/plannedFailover'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a planned failover of a recovery plan
      effect: write
      questions:
      - How do I run a planned failover for a recovery plan with no data loss?
      - Can I choose the failover direction for a planned failover?
      instructions:
      - text: Start a planned failover of recovery plan {plan} in vault {vault} (group {resource_group}, subscription {subscription}) with {properties}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
          properties: requestBody.properties
      - text: Run a planned failover on recovery plan {plan} in vault {vault} using {properties}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}/reProtect'].post
  update:
    x-apievangelist-phrasing:
      intent: Reprotect a recovery plan
      effect: write
      questions:
      - How do I reverse replication after failing over a recovery plan?
      - Can I reprotect all machines in a recovery plan at once?
      instructions:
      - text: Reprotect recovery plan {plan} in vault {vault}, group {resource_group}, subscription {subscription}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
      - text: Start reverse replication for recovery plan {plan} in vault {vault}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}/testFailover'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a test failover of a recovery plan
      effect: write
      questions:
      - Can I run a disaster recovery drill without affecting production?
      - Which network does a recovery plan test failover use?
      instructions:
      - text: Start a test failover of recovery plan {plan} in vault {vault} (group {resource_group}, subscription {subscription}) with {properties}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
          properties: requestBody.properties
      - text: Run a DR drill on recovery plan {plan} in vault {vault} using test settings {properties}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}/testFailoverCleanup'].post
  update:
    x-apievangelist-phrasing:
      intent: Clean up a recovery plan test failover
      effect: destructive
      questions:
      - How do I tear down the machines created by a test failover drill?
      - Can I add a comment when cleaning up after a recovery plan test?
      instructions:
      - text: Clean up the test failover of recovery plan {plan} in vault {vault} (group {resource_group}, subscription {subscription}) with {properties}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
          properties: requestBody.properties
      - text: Remove the test failover resources for recovery plan {plan} in vault {vault}, noting {properties}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationRecoveryPlans/{recoveryPlanName}/unplannedFailover'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an unplanned failover of a recovery plan
      effect: write
      questions:
      - How do I fail over a recovery plan during a real outage?
      - Can I fail over a recovery plan when the primary site is already down?
      instructions:
      - text: Start an unplanned failover of recovery plan {plan} in vault {vault} (group {resource_group}, subscription {subscription}) with {properties}.
        slots:
          vault: path.resourceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          plan: path.recoveryPlanName
          properties: requestBody.properties
      - text: Trigger an emergency unplanned failover on recovery plan {plan} in vault {vault} using {properties}.
        slots:
          plan: path.recoveryPlanName
          vault: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'