# 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-expressroute-circuits-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ExpressRoute circuit
      effect: read
      questions:
      - What are the details of a specific ExpressRoute circuit?
      - Can I check the SKU and provisioning state of one circuit?
      instructions:
      - text: Get ExpressRoute circuit {circuitName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show me circuit {circuitName}.
        slots:
          circuitName: path.circuitName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an ExpressRoute circuit
      effect: write
      questions:
      - How do I provision a new ExpressRoute circuit in a region?
      - Can I change the SKU of an existing ExpressRoute circuit?
      instructions:
      - text: Create ExpressRoute circuit {circuitName} in {location} under {resourceGroupName}, subscription {subscriptionId}.
        slots:
          circuitName: path.circuitName
          location: requestBody.location
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Update circuit {circuitName} to SKU {sku}.
        slots:
          circuitName: path.circuitName
          sku: requestBody.sku
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an ExpressRoute circuit
      effect: destructive
      questions:
      - Can I decommission an ExpressRoute circuit I no longer use?
      - What do I need to delete an ExpressRoute circuit?
      instructions:
      - text: Delete ExpressRoute circuit {circuitName} from {resourceGroupName} in subscription {subscriptionId}.
        slots:
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Tear down circuit {circuitName}.
        slots:
          circuitName: path.circuitName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}arpTable'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the ARP table of an ExpressRoute circuit
      effect: read
      questions:
      - Which ARP entries is my ExpressRoute circuit currently advertising?
      - Can I pull the ARP table to troubleshoot layer-2 connectivity on a circuit?
      instructions:
      - text: Get the ARP table for circuit {circuitName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the advertised ARP entries on ExpressRoute circuit {circuitName}.
        slots:
          circuitName: path.circuitName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}routesTable'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the routes table of an ExpressRoute circuit
      effect: read
      questions:
      - What routes is my ExpressRoute circuit advertising right now?
      - Can I inspect the route table of a circuit to debug BGP prefixes?
      instructions:
      - text: Get the routes table for circuit {circuitName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: List advertised routes on ExpressRoute circuit {circuitName}.
        slots:
          circuitName: path.circuitName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get traffic stats for an ExpressRoute circuit
      effect: read
      questions:
      - How much traffic has gone through my ExpressRoute circuit?
      - Can I see bytes in and out statistics for a circuit?
      instructions:
      - text: Get stats for circuit {circuitName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          circuitName: path.circuitName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show traffic statistics for ExpressRoute circuit {circuitName}.
        slots:
          circuitName: path.circuitName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits'].get
  update:
    x-apievangelist-phrasing:
      intent: List ExpressRoute circuits in a resource group
      effect: read
      questions:
      - Which ExpressRoute circuits exist in one resource group?
      - How do I list circuits scoped to a single resource group?
      instructions:
      - text: List ExpressRoute circuits in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the circuits inside {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/expressRouteCircuits'].get
  update:
    x-apievangelist-phrasing:
      intent: List all ExpressRoute circuits in a subscription
      effect: read
      questions:
      - What ExpressRoute circuits do I have across my entire subscription?
      - Can I list every circuit without knowing its resource group?
      instructions:
      - text: List all ExpressRoute circuits in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every circuit across all resource groups in {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'