# 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 NetworkResourceProviderClient Network…
  version: 1.0.0
extends: openapi/microsoft-azure-network-interfaces-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a network interface
      effect: read
      questions:
      - How do I see the IP configuration of a standalone network interface?
      - What details does Azure report for a specific NIC in a resource group?
      instructions:
      - text: Get network interface {networkInterfaceName} in resource group {resourceGroupName}.
        slots:
          networkInterfaceName: path.networkInterfaceName
          resourceGroupName: path.resourceGroupName
      - text: Show NIC {networkInterfaceName} in {resourceGroupName} under subscription {subscriptionId}.
        slots:
          networkInterfaceName: path.networkInterfaceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a network interface
      effect: write
      questions:
      - How do I create a new network interface for a VM?
      - Which location must I give when provisioning a NIC?
      instructions:
      - text: Create network interface {networkInterfaceName} in {location}.
        slots:
          networkInterfaceName: path.networkInterfaceName
          location: requestBody.location
      - text: Create or update NIC {networkInterfaceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          networkInterfaceName: path.networkInterfaceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network interface
      effect: destructive
      questions:
      - How do I delete an unattached network interface?
      - Can I clean up NICs left behind after deleting a VM?
      instructions:
      - text: Delete network interface {networkInterfaceName} from {resourceGroupName}.
        slots:
          networkInterfaceName: path.networkInterfaceName
          resourceGroupName: path.resourceGroupName
      - text: Remove NIC {networkInterfaceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          networkInterfaceName: path.networkInterfaceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.compute/virtualMachineScaleSets/{virtualMachineScaleSetName}/virtualMachines/{virtualmachineIndex}/networkInterfaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List NICs of one VM in a scale set
      effect: read
      questions:
      - Which network interfaces are attached to a single instance in my VM scale set?
      - Can I list the NICs for one scale set VM by its instance index?
      instructions:
      - text: List network interfaces for instance {virtualmachineIndex} of scale set {virtualMachineScaleSetName}.
        slots:
          virtualmachineIndex: path.virtualmachineIndex
          virtualMachineScaleSetName: path.virtualMachineScaleSetName
      - text: Show NICs on VM {virtualmachineIndex} in scale set {virtualMachineScaleSetName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          virtualmachineIndex: path.virtualmachineIndex
          virtualMachineScaleSetName: path.virtualMachineScaleSetName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.compute/virtualMachineScaleSets/{virtualMachineScaleSetName}/networkInterfaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List all NICs in a VM scale set
      effect: read
      questions:
      - What network interfaces exist across every instance of a VM scale set?
      - Can I get all the scale set's NICs in one call rather than per VM?
      instructions:
      - text: List every network interface in scale set {virtualMachineScaleSetName}.
        slots:
          virtualMachineScaleSetName: path.virtualMachineScaleSetName
      - text: Show all NICs for scale set {virtualMachineScaleSetName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          virtualMachineScaleSetName: path.virtualMachineScaleSetName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.compute/virtualMachineScaleSets/{virtualMachineScaleSetName}/virtualMachines/{virtualmachineIndex}/networkInterfaces/{networkInterfaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one NIC of a scale set VM
      effect: read
      questions:
      - How do I inspect a specific network interface on a VM scale set instance?
      - What IP settings does a named NIC on one scale set VM have?
      instructions:
      - text: Get NIC {networkInterfaceName} on instance {virtualmachineIndex} of scale set {virtualMachineScaleSetName}.
        slots:
          networkInterfaceName: path.networkInterfaceName
          virtualmachineIndex: path.virtualmachineIndex
          virtualMachineScaleSetName: path.virtualMachineScaleSetName
      - text: Show scale set NIC {networkInterfaceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          networkInterfaceName: path.networkInterfaceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/networkInterfaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List network interfaces across a subscription
      effect: read
      questions:
      - Which network interfaces exist anywhere in my subscription?
      - Is there a way to inventory every NIC across all resource groups?
      instructions:
      - text: List all network interfaces in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Inventory every NIC across my subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List network interfaces in a resource group
      effect: read
      questions:
      - What network interfaces are in one resource group?
      - Can I list only the NICs belonging to a single resource group?
      instructions:
      - text: List network interfaces in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: Show the NICs in {resourceGroupName} for subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'