# 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 Scope Connections API
  version: 1.0.0
extends: openapi/microsoft-azure-scopeconnections-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/scopeConnections/{scopeConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Network Manager scope connection
      effect: read
      questions:
      - How do I check a scope connection my Network Manager created?
      - Has the tenant accepted my Network Manager scope connection yet?
      instructions:
      - text: Get scope connection {connection} on Network Manager {networkManagerName}.
        slots:
          connection: path.scopeConnectionName
          networkManagerName: path.networkManagerName
      - text: Show the status of Network Manager scope connection {connection}.
        slots:
          connection: path.scopeConnectionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/scopeConnections/{scopeConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Network Manager scope connection
      effect: write
      questions:
      - How do I ask to manage a subscription in another tenant with Virtual Network Manager?
      - Can I create a cross-tenant scope connection from my Network Manager?
      instructions:
      - text: Create scope connection {connection} on Network Manager {networkManagerName} with properties {properties}.
        slots:
          connection: path.scopeConnectionName
          networkManagerName: path.networkManagerName
          properties: requestBody.properties
      - text: Create or replace Network Manager scope connection {connection}.
        slots:
          connection: path.scopeConnectionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/scopeConnections/{scopeConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a pending Network Manager scope connection
      effect: destructive
      questions:
      - Is it possible to withdraw a pending scope connection from my Network Manager?
      - Can I delete a scope connection that hasn't been accepted?
      instructions:
      - text: Delete scope connection {connection} from Network Manager {networkManagerName}.
        slots:
          connection: path.scopeConnectionName
          networkManagerName: path.networkManagerName
      - text: Withdraw pending Network Manager scope connection {connection}.
        slots:
          connection: path.scopeConnectionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/scopeConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List scope connections of a Network Manager
      effect: read
      questions:
      - Which scope connections has my Network Manager created?
      - Can I see all cross-tenant connections for a Network Manager?
      instructions:
      - text: List the scope connections of Network Manager {networkManagerName}.
        slots:
          networkManagerName: path.networkManagerName
      - text: Show every cross-tenant scope connection the Network Manager created.
      method: generated
      generated: '2026-10-01'