# 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-vault-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data replication vault
      effect: read
      questions:
      - How do I view the details of an Azure Site Recovery data replication vault?
      - What properties and provisioning state does my replication vault have?
      instructions:
      - text: Get replication vault {vault}.
        slots:
          vault: path.vaultName
      - text: Show the details and provisioning state of vault {vault}.
        slots:
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a data replication vault
      effect: write
      questions:
      - How do I create a new vault for Azure Site Recovery data replication?
      - Which Azure region must I choose when creating a replication vault?
      instructions:
      - text: Create replication vault {vault} in {location}.
        slots:
          vault: path.vaultName
          location: requestBody.location
      - text: Set up a new data replication vault named {vault} in {location} tagged {tags}.
        slots:
          vault: path.vaultName
          location: requestBody.location
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data replication vault
      effect: destructive
      questions:
      - How do I remove a replication vault I no longer use?
      - Can I delete a Site Recovery data replication vault by name?
      instructions:
      - text: Delete replication vault {vault}.
        slots:
          vault: path.vaultName
      - text: Permanently remove data replication vault {vault}.
        slots:
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a data replication vault
      effect: write
      questions:
      - How do I change the tags or properties of an existing replication vault?
      - Can I patch a replication vault without recreating it?
      instructions:
      - text: Update the tags on replication vault {vault} to {tags}.
        slots:
          vault: path.vaultName
          tags: requestBody.tags
      - text: Patch vault {vault} with properties {properties}.
        slots:
          vault: path.vaultName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DataReplication/replicationVaults'].get
  update:
    x-apievangelist-phrasing:
      intent: List replication vaults in a subscription
      effect: read
      questions:
      - Which data replication vaults exist across my entire subscription?
      - How do I page through every replication vault I own?
      instructions:
      - text: List all data replication vaults in my subscription.
      - text: Get the next page of subscription-wide replication vaults using token {continuation_token}.
        slots:
          continuation_token: query.continuationToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults'].get
  update:
    x-apievangelist-phrasing:
      intent: List replication vaults in a resource group
      effect: read
      questions:
      - What replication vaults are in one particular resource group?
      - How do I list just the resource group's Site Recovery data replication vaults?
      instructions:
      - text: List the data replication vaults in this resource group.
      - text: Continue listing the resource group's vaults from token {continuation_token}.
        slots:
          continuation_token: query.continuationToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of a vault operation
      effect: read
      questions:
      - How do I track whether an asynchronous operation on my replication vault has completed?
      - Where can I poll the result of a long-running vault create or delete?
      instructions:
      - text: Get the status of operation {operationId} for replication vault {vault}.
        slots:
          operationId: path.operationId
          vault: path.vaultName
      - text: Poll the async operation result on vault {vault}.
        slots:
          vault: path.vaultName
      method: generated
      generated: '2026-10-01'