# 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 NetworkGroup Network Groups API
  version: 1.0.0
extends: openapi/microsoft-azure-networkgroups-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/networkGroups/{networkGroupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a network manager network group
      effect: read
      questions:
      - What does a specific network group in my Network Manager contain?
      - Can I look up one network group by name?
      instructions:
      - text: Get network group {group} in network manager {manager}, resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          group: path.networkGroupName
      - text: Show the definition of network group {group} under manager {manager} in {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          group: path.networkGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/networkGroups/{networkGroupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a network group
      effect: write
      questions:
      - How do I create a network group to organize virtual networks in Network Manager?
      - Can I guard a network group update with an ETag?
      instructions:
      - text: Create network group {group} in network manager {manager}, resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          group: path.networkGroupName
      - text: Update network group {group} in manager {manager} ({resource_group}) only if its ETag matches {etag}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          group: path.networkGroupName
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/networkGroups/{networkGroupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network group
      effect: destructive
      questions:
      - Can I delete a network group that is still used in a configuration?
      - How do I remove a network group from my Network Manager?
      instructions:
      - text: Delete network group {group} from network manager {manager} in {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          group: path.networkGroupName
      - text: Force-delete network group {group} in manager {manager}, group {resource_group}, with force set to {force}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          group: path.networkGroupName
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/networkGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List network groups in a network manager
      effect: read
      questions:
      - Which network groups are defined in my network manager?
      - Can I page through network groups a set number at a time?
      instructions:
      - text: List the network groups in network manager {manager}, resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
      - text: Show the first {top} network groups in manager {manager} of {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/networkGroups/{networkGroupName}/listEffectiveVirtualNetworks'].post
  update:
    x-apievangelist-phrasing:
      intent: List effective virtual networks of a network group
      effect: read
      questions:
      - Which virtual networks are actually members of my network group right now?
      - Can I see the effective VNets a network group resolves to?
      instructions:
      - text: List effective virtual networks in network group {group} of manager {manager}, resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          group: path.networkGroupName
      - text: Show which VNets currently resolve into network group {group} under {manager} in {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          group: path.networkGroupName
      method: generated
      generated: '2026-09-26'