# 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 DevCenterClient Network Connections API
  version: 1.0.0
extends: openapi/microsoft-azure-network-connections-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}/providers/Microsoft.DevCenter/networkConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List Dev Center network connections in a subscription
      effect: read
      questions:
      - Which Dev Center network connections exist across my subscription?
      - Can I list every network connection for Dev Box subscription-wide?
      instructions:
      - text: List all Dev Center network connections in my subscription.
      - text: Show every network connection across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List Dev Center network connections in a resource group
      effect: read
      questions:
      - What network connections are defined in this resource group?
      - Can I list Dev Center network connections for just one resource group?
      instructions:
      - text: List the network connections in this resource group.
      - text: Show Dev Center network connections scoped to the resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Dev Center network connection
      effect: read
      questions:
      - What is the configuration of one Dev Center network connection?
      - Can I look up a network connection by name?
      instructions:
      - text: Get network connection {conn}.
        slots:
          conn: path.networkConnectionName
      - text: Show the settings of Dev Center network connection {conn}.
        slots:
          conn: path.networkConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Dev Center network connection
      effect: write
      questions:
      - How do I create a network connection for Dev Center?
      - Can I replace a network connection's settings by recreating it?
      instructions:
      - text: Create network connection {conn}.
        slots:
          conn: path.networkConnectionName
      - text: Create or replace Dev Center network connection {conn} with properties {props}.
        slots:
          conn: path.networkConnectionName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Dev Center network connection
      effect: destructive
      questions:
      - Can I delete a Dev Center network connection?
      - What happens when I remove a network connection?
      instructions:
      - text: Delete network connection {conn}.
        slots:
          conn: path.networkConnectionName
      - text: Remove Dev Center network connection {conn}.
        slots:
          conn: path.networkConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a Dev Center network connection
      effect: write
      questions:
      - Can I change just a few properties on an existing network connection?
      - Is there a partial update for Dev Center network connections?
      instructions:
      - text: Partially update network connection {conn}.
        slots:
          conn: path.networkConnectionName
      - text: Patch properties {props} on Dev Center network connection {conn}.
        slots:
          conn: path.networkConnectionName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/healthChecks'].get
  update:
    x-apievangelist-phrasing:
      intent: List health check details for a network connection
      effect: read
      questions:
      - What health checks have run against my Dev Center network connection?
      - Can I see the history of health check results for a network connection?
      instructions:
      - text: List health check details for network connection {conn}.
        slots:
          conn: path.networkConnectionName
      - text: Show all health check statuses of network connection {conn}.
        slots:
          conn: path.networkConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/healthChecks/latest'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the latest health check for a network connection
      effect: read
      questions:
      - Is my Dev Center network connection currently healthy?
      - What did the most recent health check on a network connection report?
      instructions:
      - text: Get the latest health check for network connection {conn}.
        slots:
          conn: path.networkConnectionName
      - text: Check the current health of Dev Center network connection {conn}.
        slots:
          conn: path.networkConnectionName
      method: generated
      generated: '2026-09-26'