# 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 Policy API
  version: 1.0.0
extends: openapi/microsoft-azure-policy-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: 8
- target: $.paths['/policies/{attestationType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the attestation policy for a type
      effect: read
      questions:
      - What attestation policy is currently set for SGX or TPM attestation?
      - Can I read back the policy my attestation provider is enforcing?
      instructions:
      - text: Get the attestation policy for type {attestationType}.
        slots:
          attestationType: path.attestationType
      - text: Show the current {attestationType} attestation policy.
        slots:
          attestationType: path.attestationType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policies/{attestationType}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the attestation policy for a type
      effect: write
      questions:
      - How do I upload a new attestation policy for an attestation type?
      - Can I replace the policy used to evaluate attestation evidence?
      instructions:
      - text: Set a new attestation policy for type {attestationType}.
        slots:
          attestationType: path.attestationType
      - text: Replace the {attestationType} attestation policy with my updated one.
        slots:
          attestationType: path.attestationType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/policies/{attestationType}:reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset an attestation policy to its default
      effect: destructive
      questions:
      - Can I put the attestation policy for an enclave type back to the service default?
      - What undoes a custom attestation policy I uploaded for a tenant?
      instructions:
      - text: Reset the attestation policy for type {attestationType} to default.
        slots:
          attestationType: path.attestationType
      - text: Discard my custom {attestationType} attestation policy.
        slots:
          attestationType: path.attestationType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/replicationPolicies/{policyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a replication policy in a vault
      effect: read
      questions:
      - What settings does a replication policy in my Data Replication vault have?
      - Can I look up one replication policy by its name?
      instructions:
      - text: Get replication policy {policyName} from vault {vaultName}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
      - text: Show the details of policy {policyName} in replication vault {vaultName}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/replicationPolicies/{policyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a replication policy
      effect: write
      questions:
      - How do I create a replication policy in a data replication vault?
      - What properties are required when defining a replication policy?
      instructions:
      - text: Create replication policy {policyName} in vault {vaultName} with properties {properties}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
          properties: requestBody.properties
      - text: Add a new data replication policy {policyName} to {vaultName}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/replicationPolicies/{policyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a replication policy
      effect: destructive
      questions:
      - Can I delete a replication policy from a data replication vault?
      - Is it possible to remove a replication policy I'm not using anymore?
      instructions:
      - text: Remove replication policy {policyName} from vault {vaultName}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
      - text: Delete data replication policy {policyName} in {vaultName}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/replicationPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List replication policies in a vault
      effect: read
      questions:
      - Which replication policies exist in my data replication vault?
      - What policies are configured for a replication vault?
      instructions:
      - text: List replication policies in vault {vaultName}.
        slots:
          vaultName: path.vaultName
      - text: Show every data replication policy defined in {vaultName}.
        slots:
          vaultName: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataReplication/replicationVaults/{vaultName}/replicationPolicies/{policyName}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Track an async replication policy operation
      effect: read
      questions:
      - Has the asynchronous operation on my replication policy finished?
      - How do I poll the result of a long-running policy change?
      instructions:
      - text: Check async operation {operationId} on replication policy {policyName} in vault {vaultName}.
        slots:
          operationId: path.operationId
          policyName: path.policyName
          vaultName: path.vaultName
      - text: Track the pending change on policy {policyName} of {vaultName}.
        slots:
          policyName: path.policyName
          vaultName: path.vaultName
      method: generated
      generated: '2026-10-01'