# 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 Virtual Networks API
  version: 1.0.0
extends: openapi/microsoft-azure-virtual-networks-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: 24
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualNetworks/{virtualNetworkName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Arc-enabled vSphere virtual network
      effect: read
      questions:
      - What does the vSphere virtual network I onboarded through Arc look like?
      - Can I check the settings of a VMware vSphere network managed through Azure Arc?
      instructions:
      - text: Show vSphere virtual network {virtualNetworkName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Get the Arc vSphere network {virtualNetworkName} details.
        slots:
          virtualNetworkName: path.virtualNetworkName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualNetworks/{virtualNetworkName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Arc-enabled vSphere virtual network
      effect: write
      questions:
      - How do I bring a VMware vSphere network under Arc management as a resource?
      - What location and extended location does a new vSphere virtual network resource need?
      instructions:
      - text: Create vSphere virtual network {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId} at {location}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Register the vSphere network {virtualNetworkName} using custom location {extendedLocation}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          extendedLocation: requestBody.extendedLocation
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualNetworks/{virtualNetworkName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Arc-enabled vSphere virtual network
      effect: destructive
      questions:
      - Can I force-remove a vSphere virtual network resource from Arc?
      - How do I get rid of a VMware vSphere network resource I no longer need?
      instructions:
      - text: Delete vSphere virtual network {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Delete the Arc vSphere network {virtualNetworkName} with force set to {force}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          force: query.force
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualNetworks/{virtualNetworkName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an Arc-enabled vSphere virtual network
      effect: write
      questions:
      - How do I retag a VMware vSphere virtual network resource in Arc?
      - Which properties of a vSphere virtual network resource can I patch after creation?
      instructions:
      - text: Set tags {tags} on vSphere virtual network {virtualNetworkName}.
        slots:
          tags: requestBody.tags
          virtualNetworkName: path.virtualNetworkName
      - text: Update the Arc vSphere network {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId} with new tags.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ConnectedVMwarevSphere/virtualNetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere virtual networks in a subscription
      effect: read
      questions:
      - Which VMware vSphere networks have been onboarded through Arc across my whole subscription?
      - Can I see every Arc-managed vSphere network without picking a resource group?
      instructions:
      - text: List all Arc vSphere virtual networks in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every vSphere network resource across my subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualNetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere virtual networks in a resource group
      effect: read
      questions:
      - What vSphere virtual networks live in one of my resource groups?
      - Can I list only the Arc vSphere networks inside a single resource group?
      instructions:
      - text: List vSphere virtual networks in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the Arc vSphere networks under {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualnetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List virtual networks in a DevTest lab
      effect: read
      questions:
      - Which virtual networks are attached to my DevTest Labs lab?
      - Can I filter, sort or cap the list of networks in a lab?
      instructions:
      - text: List virtual networks in lab {labName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the top {top} lab networks in {labName} ordered by {orderby}.
        slots:
          top: query.$top
          labName: path.labName
          orderby: query.$orderby
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualnetworks/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a virtual network in a DevTest lab
      effect: read
      questions:
      - How do I look up one network configured in a DevTest lab?
      - Can I expand extra properties when fetching a lab's virtual network?
      instructions:
      - text: Get lab network {name} in lab {labName} of subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          subscriptionId: path.subscriptionId
      - text: Show DevTest lab {labName} network {name} in {resourceGroupName} with {expand} expanded.
        slots:
          labName: path.labName
          name: path.name
          resourceGroupName: path.resourceGroupName
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualnetworks/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a DevTest lab virtual network
      effect: write
      questions:
      - How do I add a virtual network to a DevTest Labs lab?
      - Can I replace an existing lab network definition, and does it take long?
      instructions:
      - text: Create virtual network {name} in DevTest lab {labName} of subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          subscriptionId: path.subscriptionId
      - text: Replace lab {labName} network {name} in {resourceGroupName} with properties {properties}.
        slots:
          labName: path.labName
          name: path.name
          resourceGroupName: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualnetworks/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a virtual network from a DevTest lab
      effect: destructive
      questions:
      - How do I remove a network from a DevTest Labs lab?
      - Does deleting a lab's virtual network finish right away?
      instructions:
      - text: Delete lab network {name} from DevTest lab {labName} in subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          subscriptionId: path.subscriptionId
      - text: Remove virtual network {name} from lab {labName} in {resourceGroupName}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualnetworks/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a DevTest lab virtual network
      effect: write
      questions:
      - Can I change anything besides tags on a lab virtual network with a patch?
      - How do I tag a network inside a DevTest lab?
      instructions:
      - text: Tag lab network {name} in lab {labName} with {tags}.
        slots:
          name: path.name
          labName: path.labName
          tags: requestBody.tags
      - text: Modify the tags of DevTest lab {labName} network {name} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          labName: path.labName
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworks/{virtualNetworkName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure virtual network (Microsoft.Network)
      effect: read
      questions:
      - How do I read the details of a regular VNet in a resource group?
      - What information comes back for a Microsoft.Network virtual network?
      instructions:
      - text: Get VNet {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId} from the network provider.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the Microsoft.Network VNet {virtualNetworkName}.
        slots:
          virtualNetworkName: path.virtualNetworkName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworks/{virtualNetworkName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Microsoft.Network VNet
      effect: write
      questions:
      - How do I create a standard VNet in a resource group?
      - Can I update an existing Microsoft.Network VNet with the same call that creates it?
      instructions:
      - text: Create VNet {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId} in region {location}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Update Microsoft.Network VNet {virtualNetworkName} with properties {properties}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworks/{virtualNetworkName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Azure virtual network (Microsoft.Network)
      effect: destructive
      questions:
      - How do I delete a standard VNet I no longer use?
      - Can I remove a Microsoft.Network virtual network from a resource group?
      instructions:
      - text: Delete VNet {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the Microsoft.Network VNet {virtualNetworkName}.
        slots:
          virtualNetworkName: path.virtualNetworkName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/virtualnetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List all VNets in a subscription
      effect: read
      questions:
      - Which standard VNets exist across my entire Azure subscription?
      - Can I get every Microsoft.Network virtual network regardless of resource group?
      instructions:
      - text: List every VNet in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show all Microsoft.Network virtual networks subscription-wide.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List VNets in a resource group
      effect: read
      questions:
      - What standard VNets are in one resource group?
      - Can I list Microsoft.Network virtual networks scoped to a single resource group?
      instructions:
      - text: List VNets in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the Microsoft.Network virtual networks under {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualNetworks/{virtualNetworkName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an SCVMM virtual network
      effect: read
      questions:
      - How do I see a System Center VMM network that I onboarded?
      - What does an SCVMM virtual network resource contain?
      instructions:
      - text: Get SCVMM virtual network {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the SCVMM network {virtualNetworkName}.
        slots:
          virtualNetworkName: path.virtualNetworkName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualNetworks/{virtualNetworkName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Onboard an SCVMM virtual network
      effect: write
      questions:
      - How do I onboard a System Center VMM network as a resource?
      - What does onboarding an SCVMM network require, like a location and custom location?
      instructions:
      - text: Onboard SCVMM network {virtualNetworkName} into {resourceGroupName} of subscription {subscriptionId} at {location}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Register SCVMM virtual network {virtualNetworkName} via extended location {extendedLocation}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          extendedLocation: requestBody.extendedLocation
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualNetworks/{virtualNetworkName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Deregister an SCVMM virtual network
      effect: destructive
      questions:
      - How do I deregister a System Center VMM network?
      - Can I force the removal of an SCVMM network resource?
      instructions:
      - text: Deregister SCVMM network {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Deregister SCVMM virtual network {virtualNetworkName} with force set to {force}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          force: query.force
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualNetworks/{virtualNetworkName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an SCVMM virtual network
      effect: write
      questions:
      - How do I change the tags on an onboarded SCVMM network?
      - Can I patch a System Center VMM network resource after onboarding?
      instructions:
      - text: Set tags {tags} on SCVMM network {virtualNetworkName}.
        slots:
          tags: requestBody.tags
          virtualNetworkName: path.virtualNetworkName
      - text: Update SCVMM virtual network {virtualNetworkName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualNetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCVMM virtual networks in a resource group
      effect: read
      questions:
      - Which SCVMM networks are onboarded in a given resource group?
      - Can I list System Center VMM networks just for one resource group?
      instructions:
      - text: List SCVMM virtual networks in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show onboarded SCVMM networks under resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ScVmm/virtualNetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCVMM virtual networks in a subscription
      effect: read
      questions:
      - What SCVMM networks have I onboarded across the whole subscription?
      - Can I see every System Center VMM network resource subscription-wide?
      instructions:
      - text: List all SCVMM virtual networks in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every onboarded SCVMM network across my subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/locations/{regionId}/privateClouds/{pcName}/virtualNetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List CloudSimple private cloud virtual networks
      effect: read
      questions:
      - Which virtual networks are available in my VMware CloudSimple private cloud?
      - Do I need a resource pool to list the networks in a CloudSimple private cloud?
      instructions:
      - text: List virtual networks in private cloud {pcName} in region {regionId} for resource pool {resourcePoolName}.
        slots:
          pcName: path.pcName
          regionId: path.regionId
          resourcePoolName: query.resourcePoolName
      - text: Show CloudSimple networks available to pool {resourcePoolName} in {pcName} for subscription {subscriptionId}.
        slots:
          resourcePoolName: query.resourcePoolName
          pcName: path.pcName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/locations/{regionId}/privateClouds/{pcName}/virtualNetworks/{virtualNetworkName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a CloudSimple private cloud virtual network
      effect: read
      questions:
      - How do I look up one network in a CloudSimple private cloud by name?
      - What does a VMware CloudSimple virtual network record show?
      instructions:
      - text: Get CloudSimple network {virtualNetworkName} in private cloud {pcName} in {regionId}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          pcName: path.pcName
          regionId: path.regionId
      - text: Show private cloud {pcName} network {virtualNetworkName} in subscription {subscriptionId}.
        slots:
          pcName: path.pcName
          virtualNetworkName: path.virtualNetworkName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'