# 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 Microsoft NetApp Volumes Replication API
  version: 1.0.0
extends: openapi/microsoft-azure-volumes-replication-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/breakReplication'].post
  update:
    x-apievangelist-phrasing:
      intent: Break replication on a destination volume
      effect: destructive
      questions:
      - How do I break the replication on an Azure NetApp Files destination volume to fail over?
      - Can I force-break a volume replication?
      instructions:
      - text: Break replication on volume {volumeName} in pool {poolName} of account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Force-break replication on destination volume {volumeName} in {poolName}, account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/reestablishReplication'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-establish a deleted volume replication
      effect: write
      questions:
      - How do I restore a replication I deleted between two volumes that share snapshots?
      - Can I reconnect a destination volume to its original source volume?
      instructions:
      - text: Re-establish replication on volume {volumeName} in pool {poolName}, account {accountName}, from source {sourceVolumeId}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
          sourceVolumeId: requestBody.sourceVolumeId
      - text: Restore the deleted replication between {sourceVolumeId} and volume {volumeName}.
        slots:
          sourceVolumeId: requestBody.sourceVolumeId
          volumeName: path.volumeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/replicationStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a volume's replication status
      effect: read
      questions:
      - Is my NetApp volume replication healthy and mirrored?
      - How far along is the transfer for a replicated volume?
      instructions:
      - text: Get the replication status of volume {volumeName} in pool {poolName}, account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Check whether replication on {volumeName} is healthy.
        slots:
          volumeName: path.volumeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/listReplications'].post
  update:
    x-apievangelist-phrasing:
      intent: List replications for a volume
      effect: read
      questions:
      - Which replication relationships does a NetApp volume have?
      - Can I see all replications configured for one volume?
      instructions:
      - text: List all replications for volume {volumeName} in pool {poolName}, account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Show every replication relationship on volume {volumeName}.
        slots:
          volumeName: path.volumeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/resyncReplication'].post
  update:
    x-apievangelist-phrasing:
      intent: Resync a volume replication
      effect: write
      questions:
      - How do I resume syncing a destination volume after a broken replication?
      - What happens if I run a resync on the source volume instead of the destination?
      instructions:
      - text: Resync replication on volume {volumeName} in pool {poolName}, account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Reverse-resync from destination back to source volume {volumeName}.
        slots:
          volumeName: path.volumeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/deleteReplication'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a volume replication connection
      effect: destructive
      questions:
      - How do I permanently remove the replication connection on a destination volume?
      - Does deleting a replication release the source volume too?
      instructions:
      - text: Delete the replication on destination volume {volumeName} in pool {poolName}, account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Tear down replication for {volumeName} and release the source.
        slots:
          volumeName: path.volumeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/authorizeReplication'].post
  update:
    x-apievangelist-phrasing:
      intent: Authorize replication from a source volume
      effect: write
      questions:
      - How do I approve a cross-region replication on the source volume side?
      - What remote volume ID do I need to authorize a replication?
      instructions:
      - text: Authorize replication from source volume {volumeName} in pool {poolName}, account {accountName}, to {remoteVolumeResourceId}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
          remoteVolumeResourceId: requestBody.remoteVolumeResourceId
      - text: Allow {remoteVolumeResourceId} to replicate from volume {volumeName}.
        slots:
          remoteVolumeResourceId: requestBody.remoteVolumeResourceId
          volumeName: path.volumeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/reinitializeReplication'].post
  update:
    x-apievangelist-phrasing:
      intent: Reinitialize a volume replication
      effect: write
      questions:
      - How do I restart the baseline transfer of a replication on a destination volume?
      - Can I re-initialize a replication connection that has stalled?
      instructions:
      - text: Reinitialize replication on destination volume {volumeName} in pool {poolName}, account {accountName}.
        slots:
          volumeName: path.volumeName
          poolName: path.poolName
          accountName: path.accountName
      - text: Restart the replication baseline for volume {volumeName}.
        slots:
          volumeName: path.volumeName
      method: generated
      generated: '2026-09-26'