# 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 VirtualWANAsAServiceManagementClient…
  version: 1.0.0
extends: openapi/microsoft-azure-expressrouteconnections-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/expressRouteGateways/{expressRouteGatewayName}/expressRouteConnections/{connectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ExpressRoute connection
      effect: read
      questions:
      - What are the settings of an ExpressRoute connection on my gateway?
      - Can I check the routing configuration of one ExpressRoute connection?
      instructions:
      - text: Get ExpressRoute connection {connection} on gateway {gateway} in resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          gateway: path.expressRouteGatewayName
          connection: path.connectionName
      - text: Show the details of connection {connection} on ExpressRoute gateway {gateway} ({resource_group}).
        slots:
          resource_group: path.resourceGroupName
          gateway: path.expressRouteGatewayName
          connection: path.connectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteGateways/{expressRouteGatewayName}/expressRouteConnections/{connectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Connect an ExpressRoute gateway to a circuit
      effect: write
      questions:
      - How do I connect my ExpressRoute gateway to an ExpressRoute circuit?
      - Can I update an existing ExpressRoute connection's properties?
      instructions:
      - text: Create connection {connection} named {name} on gateway {gateway} in {resource_group} to the circuit in {properties}.
        slots:
          resource_group: path.resourceGroupName
          gateway: path.expressRouteGatewayName
          connection: path.connectionName
          name: requestBody.name
          properties: requestBody.properties
      - text: Link ExpressRoute gateway {gateway} in {resource_group} to a circuit through connection {connection} called {name}.
        slots:
          resource_group: path.resourceGroupName
          gateway: path.expressRouteGatewayName
          connection: path.connectionName
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteGateways/{expressRouteGatewayName}/expressRouteConnections/{connectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an ExpressRoute connection
      effect: destructive
      questions:
      - Can I disconnect my gateway from an ExpressRoute circuit?
      - What happens when I delete an ExpressRoute connection?
      instructions:
      - text: Delete ExpressRoute connection {connection} from gateway {gateway} in {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          gateway: path.expressRouteGatewayName
          connection: path.connectionName
      - text: Disconnect the circuit link {connection} on ExpressRoute gateway {gateway} ({resource_group}).
        slots:
          resource_group: path.resourceGroupName
          gateway: path.expressRouteGatewayName
          connection: path.connectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteGateways/{expressRouteGatewayName}/expressRouteConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List ExpressRoute connections on a gateway
      effect: read
      questions:
      - Which ExpressRoute circuits is my gateway connected to?
      - Can I list all connections on an ExpressRoute gateway?
      instructions:
      - text: List ExpressRoute connections on gateway {gateway} in resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          gateway: path.expressRouteGatewayName
      - text: Show every circuit connection attached to ExpressRoute gateway {gateway} ({resource_group}).
        slots:
          resource_group: path.resourceGroupName
          gateway: path.expressRouteGatewayName
      method: generated
      generated: '2026-09-26'