# 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 NetworkResourceProviderClient Express Route…
  version: 1.0.0
extends: openapi/microsoft-azure-expressroutecircuitauthorizations-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/authorizations/{authorizationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ExpressRoute circuit authorization
      effect: read
      questions:
      - How do I retrieve the authorization key for an ExpressRoute circuit authorization?
      - Has a given circuit authorization already been used?
      instructions:
      - text: Get authorization {authorization} on ExpressRoute circuit {circuit} in resource group {resource_group}, subscription {subscription}.
        slots:
          authorization: path.authorizationName
          circuit: path.circuitName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the key and use status of authorization {authorization} on circuit {circuit}.
        slots:
          authorization: path.authorizationName
          circuit: path.circuitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/authorizations/{authorizationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an ExpressRoute circuit authorization
      effect: write
      questions:
      - How do I let another subscription connect its virtual network to my ExpressRoute circuit?
      - Can I generate a new authorization key for a circuit?
      instructions:
      - text: Create authorization {authorization} on ExpressRoute circuit {circuit} in resource group {resource_group}, subscription {subscription}.
        slots:
          authorization: path.authorizationName
          circuit: path.circuitName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Issue a new circuit authorization named {authorization} for circuit {circuit}.
        slots:
          authorization: path.authorizationName
          circuit: path.circuitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/authorizations/{authorizationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an ExpressRoute circuit authorization
      effect: destructive
      questions:
      - How do I revoke an ExpressRoute authorization key I shared?
      - Can I delete an authorization from a circuit?
      instructions:
      - text: Delete authorization {authorization} from ExpressRoute circuit {circuit} in resource group {resource_group}, subscription {subscription}.
        slots:
          authorization: path.authorizationName
          circuit: path.circuitName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Revoke the {authorization} key on circuit {circuit}.
        slots:
          authorization: path.authorizationName
          circuit: path.circuitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/authorizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List authorizations on an ExpressRoute circuit
      effect: read
      questions:
      - Which authorization keys exist on my ExpressRoute circuit?
      - Can I list every authorization issued for a circuit?
      instructions:
      - text: List authorizations on ExpressRoute circuit {circuit} in resource group {resource_group}, subscription {subscription}.
        slots:
          circuit: path.circuitName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show all authorization keys issued for circuit {circuit}.
        slots:
          circuit: path.circuitName
      method: generated
      generated: '2026-09-26'