# 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 AttestationManagementClient Attestation…
  version: 1.0.0
extends: openapi/microsoft-azure-attestationproviders-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.Attestation/attestationProviders/{providerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an attestation provider
      effect: read
      questions:
      - What is the status of my Azure Attestation provider?
      - How do I read the attest URI and properties of one attestation provider?
      instructions:
      - text: Get attestation provider {providerName}.
        slots:
          providerName: path.providerName
      - text: Show the status of attestation provider {providerName}.
        slots:
          providerName: path.providerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Attestation/attestationProviders/{providerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an attestation provider
      effect: write
      questions:
      - How do I create a new Azure Attestation provider in a region?
      - Can I supply policy signing certificates when creating an attestation provider?
      instructions:
      - text: Create attestation provider {providerName} in {location}.
        slots:
          providerName: path.providerName
          location: requestBody.location
      - text: Create or replace attestation provider {providerName} with properties {properties}.
        slots:
          providerName: path.providerName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Attestation/attestationProviders/{providerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an attestation provider
      effect: destructive
      questions:
      - How do I remove an attestation service I no longer need?
      - Can I delete a custom attestation provider from my resource group?
      instructions:
      - text: Delete attestation provider {providerName}.
        slots:
          providerName: path.providerName
      - text: Remove the attestation service {providerName}.
        slots:
          providerName: path.providerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Attestation/attestationProviders/{providerName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an attestation provider's tags
      effect: write
      questions:
      - Can I change the tags on an existing attestation provider?
      - How do I patch an attestation provider without recreating it?
      instructions:
      - text: Update attestation provider {providerName} with tags {tags}.
        slots:
          providerName: path.providerName
          tags: requestBody.tags
      - text: Patch the properties of attestation provider {providerName}.
        slots:
          providerName: path.providerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Attestation/attestationProviders'].get
  update:
    x-apievangelist-phrasing:
      intent: List attestation providers in a subscription
      effect: read
      questions:
      - Which attestation providers exist across my whole subscription?
      - How many Azure Attestation instances does my subscription have?
      instructions:
      - text: List all attestation providers in my subscription with API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show every attestation provider across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Attestation/attestationProviders'].get
  update:
    x-apievangelist-phrasing:
      intent: List attestation providers in a resource group
      effect: read
      questions:
      - Which attestation providers live in one particular resource group?
      - Can I narrow the attestation provider list to a single resource group?
      instructions:
      - text: List attestation providers in this resource group with API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show the attestation providers scoped to my resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Attestation/defaultProviders'].get
  update:
    x-apievangelist-phrasing:
      intent: List default attestation providers
      effect: read
      questions:
      - What are the shared default attestation providers Microsoft runs?
      - Is there a default attestation provider I can use without creating my own?
      instructions:
      - text: List the default attestation providers with API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show the shared regional default attestation providers.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Attestation/locations/{location}/defaultProvider'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default attestation provider for a region
      effect: read
      questions:
      - Which shared attestation provider serves a specific Azure region?
      - How do I find the default attestation endpoint for East US?
      instructions:
      - text: Get the default attestation provider in {location}.
        slots:
          location: path.location
      - text: Show the regional shared attestation endpoint for {location}.
        slots:
          location: path.location
      method: generated
      generated: '2026-09-26'