# 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 Azure Orbital L2 Connection API
  version: 1.0.0
extends: openapi/microsoft-azure-l2-connection-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.Orbital/l2Connections/{l2ConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Orbital L2 connection
      effect: read
      questions:
      - Where do I find one Azure Orbital L2 connection's details?
      - What are the settings of a specific layer 2 connection?
      instructions:
      - text: Get L2 connection {l2ConnectionName}.
        slots:
          l2ConnectionName: path.l2ConnectionName
      - text: Show the details of Orbital layer 2 connection {l2ConnectionName}.
        slots:
          l2ConnectionName: path.l2ConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/l2Connections/{l2ConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Orbital L2 connection
      effect: write
      questions:
      - How do I create a layer 2 connection for an Azure Orbital ground station?
      - Can I reconfigure an existing L2 connection's properties?
      instructions:
      - text: Create L2 connection {l2ConnectionName} with properties {properties}.
        slots:
          l2ConnectionName: path.l2ConnectionName
          properties: requestBody.properties
      - text: Create or update Orbital L2 connection {l2ConnectionName}.
        slots:
          l2ConnectionName: path.l2ConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/l2Connections/{l2ConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Orbital L2 connection
      effect: destructive
      questions:
      - Can I remove a layer 2 connection from Azure Orbital?
      - Can I delete an L2 connection that's no longer needed?
      instructions:
      - text: Delete L2 connection {l2ConnectionName}.
        slots:
          l2ConnectionName: path.l2ConnectionName
      - text: Remove Orbital layer 2 connection {l2ConnectionName}.
        slots:
          l2ConnectionName: path.l2ConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/l2Connections/{l2ConnectionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an L2 connection
      effect: write
      questions:
      - Can I retag an Orbital L2 connection without touching its configuration?
      - Which call changes the tags on a layer 2 connection?
      instructions:
      - text: Set tags {tags} on L2 connection {l2ConnectionName}.
        slots:
          tags: requestBody.tags
          l2ConnectionName: path.l2ConnectionName
      - text: Update the tags of Orbital layer 2 connection {l2ConnectionName}.
        slots:
          l2ConnectionName: path.l2ConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/l2Connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List L2 connections in a resource group
      effect: read
      questions:
      - Which Orbital L2 connections are in my resource group?
      - Does the resource-group L2 connection list page with a skip token?
      instructions:
      - text: List the L2 connections in my resource group.
      - text: Get the next page of resource-group L2 connections from token {skiptoken}.
        slots:
          skiptoken: query.$skiptoken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Orbital/l2Connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List L2 connections in a subscription
      effect: read
      questions:
      - What Orbital layer 2 connections exist across my whole subscription?
      - Can I list L2 connections without naming a resource group?
      instructions:
      - text: List all L2 connections in my subscription.
      - text: Continue listing subscription-wide L2 connections from page token {skiptoken}.
        slots:
          skiptoken: query.$skiptoken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/edgeSites/{edgeSiteName}/listL2Connections'].post
  update:
    x-apievangelist-phrasing:
      intent: List L2 connections on an edge site
      effect: read
      questions:
      - Which layer 2 connections are attached to a particular Orbital edge site?
      - Can I see the L2 connections for one edge site?
      instructions:
      - text: List the L2 connections attached to edge site {edgeSiteName}.
        slots:
          edgeSiteName: path.edgeSiteName
      - text: Show which layer 2 connections use edge site {edgeSiteName}.
        slots:
          edgeSiteName: path.edgeSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/groundStations/{groundStationName}/listL2Connections'].post
  update:
    x-apievangelist-phrasing:
      intent: List L2 connections on a ground station
      effect: read
      questions:
      - Which L2 connections are attached to an Orbital ground station?
      - How can I see the layer 2 links for one ground station?
      instructions:
      - text: List the L2 connections attached to ground station {groundStationName}.
        slots:
          groundStationName: path.groundStationName
      - text: Show layer 2 connections for ground station {groundStationName}.
        slots:
          groundStationName: path.groundStationName
      method: generated
      generated: '2026-09-26'