# 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 Dra…
  version: 1.0.0
extends: openapi/microsoft-azure-dra-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationFabrics/{fabricName}/fabricAgents/{fabricAgentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a replication fabric agent
      effect: read
      questions:
      - What are the details of a fabric agent in my replication fabric?
      - Can I look up one DRA by name?
      instructions:
      - text: Get fabric agent {fabricAgentName} in fabric {fabricName}.
        slots:
          fabricAgentName: path.fabricAgentName
          fabricName: path.fabricName
      - text: Show the DRA {fabricAgentName} of replication fabric {fabricName}.
        slots:
          fabricAgentName: path.fabricAgentName
          fabricName: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationFabrics/{fabricName}/fabricAgents/{fabricAgentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a replication fabric agent
      effect: write
      questions:
      - How do I register a new fabric agent in a replication fabric?
      - Can I add a DRA to an existing fabric?
      instructions:
      - text: Create fabric agent {fabricAgentName} in fabric {fabricName}.
        slots:
          fabricAgentName: path.fabricAgentName
          fabricName: path.fabricName
      - text: Add DRA {fabricAgentName} to replication fabric {fabricName}.
        slots:
          fabricAgentName: path.fabricAgentName
          fabricName: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationFabrics/{fabricName}/fabricAgents/{fabricAgentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a replication fabric agent
      effect: destructive
      questions:
      - Can I delete a fabric agent from my replication fabric?
      - Is it possible to unregister a DRA?
      instructions:
      - text: Delete fabric agent {fabricAgentName} from fabric {fabricName}.
        slots:
          fabricAgentName: path.fabricAgentName
          fabricName: path.fabricName
      - text: Remove DRA {fabricAgentName} from replication fabric {fabricName}.
        slots:
          fabricAgentName: path.fabricAgentName
          fabricName: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationFabrics/{fabricName}/fabricAgents'].get
  update:
    x-apievangelist-phrasing:
      intent: List fabric agents in a replication fabric
      effect: read
      questions:
      - Which fabric agents are registered in my replication fabric?
      - Can I list every DRA in a fabric?
      instructions:
      - text: List fabric agents in fabric {fabricName}.
        slots:
          fabricName: path.fabricName
      - text: Show all DRAs of replication fabric {fabricName}.
        slots:
          fabricName: path.fabricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationFabrics/{fabricName}/fabricAgents/{fabricAgentName}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Track an async operation on a fabric agent
      effect: read
      questions:
      - Did the asynchronous operation on my fabric agent finish?
      - Can I track the result of a long-running DRA operation?
      instructions:
      - text: Check async operation {operationId} for fabric agent {fabricAgentName} in fabric {fabricName}.
        slots:
          operationId: path.operationId
          fabricAgentName: path.fabricAgentName
          fabricName: path.fabricName
      - text: Track the pending operation on DRA {fabricAgentName} of fabric {fabricName}.
        slots:
          fabricAgentName: path.fabricAgentName
          fabricName: path.fabricName
      method: generated
      generated: '2026-10-01'