# 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-expressroutecircuitpeerings-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}/peerings/{peeringName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ExpressRoute circuit peering
      effect: read
      questions:
      - How is the private or Microsoft peering on my ExpressRoute circuit configured?
      - Can I check the VLAN and ASN settings of one circuit peering?
      instructions:
      - text: Get peering {peeringName} on ExpressRoute circuit {circuitName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          peeringName: path.peeringName
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the settings of circuit peering {peeringName} on {circuitName}.
        slots:
          peeringName: path.peeringName
          circuitName: path.circuitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/peerings/{peeringName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an ExpressRoute peering
      effect: write
      questions:
      - How do I set up private peering on a new ExpressRoute circuit?
      - Can I change the settings of an existing circuit peering?
      instructions:
      - text: Create peering {peeringName} on ExpressRoute circuit {circuitName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          peeringName: path.peeringName
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Configure circuit peering {peeringName} on {circuitName} with properties {properties}.
        slots:
          peeringName: path.peeringName
          circuitName: path.circuitName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/peerings/{peeringName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an ExpressRoute circuit peering
      effect: destructive
      questions:
      - How do I remove a peering from my ExpressRoute circuit?
      - Can I delete Microsoft peering while keeping the circuit itself?
      instructions:
      - text: Delete peering {peeringName} from ExpressRoute circuit {circuitName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          peeringName: path.peeringName
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove circuit peering {peeringName} on {circuitName}.
        slots:
          peeringName: path.peeringName
          circuitName: path.circuitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/peerings'].get
  update:
    x-apievangelist-phrasing:
      intent: List peerings on an ExpressRoute circuit
      effect: read
      questions:
      - Which peerings are configured on my ExpressRoute circuit?
      - Does my circuit have both private and Microsoft peering set up?
      instructions:
      - text: List peerings on ExpressRoute circuit {circuitName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show all peerings configured on circuit {circuitName}.
        slots:
          circuitName: path.circuitName
      method: generated
      generated: '2026-09-26'