# 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 Azure VMware Solution Workload Networks API
  version: 1.0.0
extends: openapi/microsoft-azure-workloadnetworks-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: 34
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/segments'].get
  update:
    x-apievangelist-phrasing:
      intent: List network segments in an AVS private cloud
      effect: read
      questions:
      - Which network segments exist in my Azure VMware Solution private cloud's workload network?
      - Can I see every NSX segment configured for a private cloud at once?
      instructions:
      - text: List all workload network segments in private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show me every segment defined in the workload network of {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/segments/{segmentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one workload network segment
      effect: read
      questions:
      - What are the settings of a specific segment in my AVS workload network?
      - Can I look up a single network segment by its ID in a private cloud?
      instructions:
      - text: Get segment {segmentId} from the workload network of private cloud {privateCloudName}.
        slots:
          segmentId: path.segmentId
          privateCloudName: path.privateCloudName
      - text: Show the details of workload segment {segmentId} in {privateCloudName}.
        slots:
          segmentId: path.segmentId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/segments/{segmentId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a new workload network segment
      effect: write
      questions:
      - How do I add a new network segment to my Azure VMware Solution private cloud?
      - Can I create a brand-new NSX segment with its own ID in the workload network?
      instructions:
      - text: Create a new segment {segmentId} in the workload network of private cloud {privateCloudName}.
        slots:
          segmentId: path.segmentId
          privateCloudName: path.privateCloudName
      - text: 'Add segment {segmentId} to {privateCloudName} using these segment properties: {properties}.'
        slots:
          segmentId: path.segmentId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/segments/{segmentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workload network segment
      effect: destructive
      questions:
      - How do I remove a network segment from my AVS private cloud?
      - What happens to a workload segment once I delete it from the private cloud?
      instructions:
      - text: Delete segment {segmentId} from private cloud {privateCloudName}.
        slots:
          segmentId: path.segmentId
          privateCloudName: path.privateCloudName
      - text: Remove the workload network segment {segmentId} in {privateCloudName}.
        slots:
          segmentId: path.segmentId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/segments/{segmentId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing workload network segment
      effect: write
      questions:
      - Can I change the properties of a segment that already exists in my private cloud workload network?
      - Is it possible to patch only part of an existing AVS segment's configuration?
      instructions:
      - text: Update existing segment {segmentId} in private cloud {privateCloudName} with {properties}.
        slots:
          segmentId: path.segmentId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      - text: Patch the configuration of workload segment {segmentId} in {privateCloudName}.
        slots:
          segmentId: path.segmentId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dhcpConfigurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List DHCP configurations in an AVS private cloud
      effect: read
      questions:
      - Which DHCP server and relay configurations are set up in my private cloud workload network?
      - Can I see all DHCP entries for an Azure VMware Solution private cloud?
      instructions:
      - text: List all DHCP configurations in the workload network of {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show every DHCP setup for private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dhcpConfigurations/{dhcpId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one DHCP configuration
      effect: read
      questions:
      - What does a particular DHCP configuration in my AVS workload network look like?
      - Can I fetch a single DHCP entry by its ID?
      instructions:
      - text: Get DHCP configuration {dhcpId} in private cloud {privateCloudName}.
        slots:
          dhcpId: path.dhcpId
          privateCloudName: path.privateCloudName
      - text: Show details for DHCP entry {dhcpId} in {privateCloudName}.
        slots:
          dhcpId: path.dhcpId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dhcpConfigurations/{dhcpId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a new DHCP configuration
      effect: write
      questions:
      - How do I set up a new DHCP server or relay in my private cloud workload network?
      - Can I add a fresh DHCP configuration with an ID I choose?
      instructions:
      - text: Create a new DHCP configuration {dhcpId} in private cloud {privateCloudName}.
        slots:
          dhcpId: path.dhcpId
          privateCloudName: path.privateCloudName
      - text: Add DHCP entry {dhcpId} to {privateCloudName} with properties {properties}.
        slots:
          dhcpId: path.dhcpId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dhcpConfigurations/{dhcpId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DHCP configuration
      effect: destructive
      questions:
      - How do I remove a DHCP configuration from my AVS private cloud?
      - Can a DHCP entry be deleted from the workload network by its ID?
      instructions:
      - text: Delete DHCP configuration {dhcpId} from private cloud {privateCloudName}.
        slots:
          dhcpId: path.dhcpId
          privateCloudName: path.privateCloudName
      - text: Remove the DHCP entry {dhcpId} in {privateCloudName}.
        slots:
          dhcpId: path.dhcpId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dhcpConfigurations/{dhcpId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing DHCP configuration
      effect: write
      questions:
      - Can I change settings on a DHCP configuration that's already in my workload network?
      - Is there a way to patch an existing DHCP relay without recreating it?
      instructions:
      - text: Update existing DHCP configuration {dhcpId} in {privateCloudName} with {properties}.
        slots:
          dhcpId: path.dhcpId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      - text: Patch DHCP entry {dhcpId} in private cloud {privateCloudName}.
        slots:
          dhcpId: path.dhcpId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/gateways'].get
  update:
    x-apievangelist-phrasing:
      intent: List gateways in an AVS private cloud
      effect: read
      questions:
      - Which gateways are attached to my private cloud workload network?
      - Can I see all the NSX gateways available in an Azure VMware Solution private cloud?
      instructions:
      - text: List the workload network gateways in private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show all gateways for {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/gateways/{gatewayId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one workload network gateway
      effect: read
      questions:
      - What are the details of a specific gateway in my AVS workload network?
      - Can I look up a gateway by its ID in a private cloud?
      instructions:
      - text: Get gateway {gatewayId} in private cloud {privateCloudName}.
        slots:
          gatewayId: path.gatewayId
          privateCloudName: path.privateCloudName
      - text: Show the workload network gateway {gatewayId} from {privateCloudName}.
        slots:
          gatewayId: path.gatewayId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/portMirroringProfiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List port mirroring profiles in a private cloud
      effect: read
      questions:
      - Which port mirroring profiles are configured in my AVS workload network?
      - Can I see all traffic mirroring profiles for a private cloud?
      instructions:
      - text: List port mirroring profiles in private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show every port mirroring profile set up in {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/portMirroringProfiles/{portMirroringId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one port mirroring profile
      effect: read
      questions:
      - What does a specific port mirroring profile in my private cloud contain?
      - Can I fetch one port mirroring profile by its ID?
      instructions:
      - text: Get port mirroring profile {portMirroringId} in private cloud {privateCloudName}.
        slots:
          portMirroringId: path.portMirroringId
          privateCloudName: path.privateCloudName
      - text: Show the settings of port mirroring profile {portMirroringId} in {privateCloudName}.
        slots:
          portMirroringId: path.portMirroringId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/portMirroringProfiles/{portMirroringId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a new port mirroring profile
      effect: write
      questions:
      - How do I start mirroring VM traffic by adding a port mirroring profile in AVS?
      - Can I create a new port mirroring profile with an ID I pick?
      instructions:
      - text: Create a new port mirroring profile {portMirroringId} in private cloud {privateCloudName}.
        slots:
          portMirroringId: path.portMirroringId
          privateCloudName: path.privateCloudName
      - text: Add port mirroring profile {portMirroringId} to {privateCloudName} with {properties}.
        slots:
          portMirroringId: path.portMirroringId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/portMirroringProfiles/{portMirroringId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a port mirroring profile
      effect: destructive
      questions:
      - How do I stop port mirroring by removing its profile from the private cloud?
      - Can I delete a port mirroring profile by ID?
      instructions:
      - text: Delete port mirroring profile {portMirroringId} from private cloud {privateCloudName}.
        slots:
          portMirroringId: path.portMirroringId
          privateCloudName: path.privateCloudName
      - text: Remove the port mirroring profile {portMirroringId} in {privateCloudName}.
        slots:
          portMirroringId: path.portMirroringId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/portMirroringProfiles/{portMirroringId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing port mirroring profile
      effect: write
      questions:
      - Can I change the source or destination of a port mirroring profile I already have?
      - Is it possible to patch an existing port mirroring profile in AVS?
      instructions:
      - text: Update existing port mirroring profile {portMirroringId} in {privateCloudName} with {properties}.
        slots:
          portMirroringId: path.portMirroringId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      - text: Patch port mirroring profile {portMirroringId} in private cloud {privateCloudName}.
        slots:
          portMirroringId: path.portMirroringId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/vmGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List VM groups in an AVS private cloud
      effect: read
      questions:
      - Which VM groups are defined in my private cloud workload network?
      - Can I list all the virtual machine groups for an Azure VMware Solution private cloud?
      instructions:
      - text: List the VM groups in private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show every VM group in the workload network of {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/vmGroups/{vmGroupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one VM group
      effect: read
      questions:
      - Which VMs belong to a specific VM group in my private cloud?
      - Can I look up a VM group's details by its ID?
      instructions:
      - text: Get VM group {vmGroupId} in private cloud {privateCloudName}.
        slots:
          vmGroupId: path.vmGroupId
          privateCloudName: path.privateCloudName
      - text: Show the members and settings of VM group {vmGroupId} in {privateCloudName}.
        slots:
          vmGroupId: path.vmGroupId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/vmGroups/{vmGroupId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a new VM group
      effect: write
      questions:
      - How do I group virtual machines together in my AVS workload network?
      - Can I create a new VM group with an ID of my choosing?
      instructions:
      - text: Create a new VM group {vmGroupId} in private cloud {privateCloudName}.
        slots:
          vmGroupId: path.vmGroupId
          privateCloudName: path.privateCloudName
      - text: Add VM group {vmGroupId} to {privateCloudName} with properties {properties}.
        slots:
          vmGroupId: path.vmGroupId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/vmGroups/{vmGroupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a VM group
      effect: destructive
      questions:
      - How do I delete a VM group from my private cloud workload network?
      - Can I remove a VM group by its ID?
      instructions:
      - text: Delete VM group {vmGroupId} from private cloud {privateCloudName}.
        slots:
          vmGroupId: path.vmGroupId
          privateCloudName: path.privateCloudName
      - text: Remove the VM group {vmGroupId} in {privateCloudName}.
        slots:
          vmGroupId: path.vmGroupId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/vmGroups/{vmGroupId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing VM group
      effect: write
      questions:
      - Can I change which VMs are in a VM group that already exists?
      - Is there a way to patch an existing VM group's properties?
      instructions:
      - text: Update existing VM group {vmGroupId} in {privateCloudName} with {properties}.
        slots:
          vmGroupId: path.vmGroupId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      - text: Patch VM group {vmGroupId} in private cloud {privateCloudName}.
        slots:
          vmGroupId: path.vmGroupId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/virtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List virtual machines in a private cloud network
      effect: read
      questions:
      - Which virtual machines are visible in my private cloud workload network?
      - Can I get a list of every VM the AVS workload network knows about?
      instructions:
      - text: List the virtual machines in the workload network of {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show all VMs for private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/virtualMachines/{virtualMachineId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one virtual machine in a private cloud network
      effect: read
      questions:
      - What does the workload network report for a specific virtual machine?
      - Can I look up a single VM in my AVS private cloud by its ID?
      instructions:
      - text: Get virtual machine {virtualMachineId} in private cloud {privateCloudName}.
        slots:
          virtualMachineId: path.virtualMachineId
          privateCloudName: path.privateCloudName
      - text: Show the workload network details for VM {virtualMachineId} in {privateCloudName}.
        slots:
          virtualMachineId: path.virtualMachineId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List DNS services in an AVS private cloud
      effect: read
      questions:
      - Which DNS services are running in my private cloud workload network?
      - Can I see all DNS forwarder services configured for an AVS private cloud?
      instructions:
      - text: List the DNS services in private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show every DNS service in the workload network of {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsServices/{dnsServiceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one DNS service
      effect: read
      questions:
      - What is configured on a particular DNS service in my private cloud?
      - Can I fetch a DNS service by its ID?
      instructions:
      - text: Get DNS service {dnsServiceId} in private cloud {privateCloudName}.
        slots:
          dnsServiceId: path.dnsServiceId
          privateCloudName: path.privateCloudName
      - text: Show the settings of DNS service {dnsServiceId} in {privateCloudName}.
        slots:
          dnsServiceId: path.dnsServiceId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsServices/{dnsServiceId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a new DNS service
      effect: write
      questions:
      - How do I add a DNS service to my Azure VMware Solution workload network?
      - Can I create a new DNS service with an ID I choose?
      instructions:
      - text: Create a new DNS service {dnsServiceId} in private cloud {privateCloudName}.
        slots:
          dnsServiceId: path.dnsServiceId
          privateCloudName: path.privateCloudName
      - text: Add DNS service {dnsServiceId} to {privateCloudName} with properties {properties}.
        slots:
          dnsServiceId: path.dnsServiceId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsServices/{dnsServiceId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DNS service
      effect: destructive
      questions:
      - How do I remove a DNS service from my private cloud?
      - Can I delete a workload network DNS service by its ID?
      instructions:
      - text: Delete DNS service {dnsServiceId} from private cloud {privateCloudName}.
        slots:
          dnsServiceId: path.dnsServiceId
          privateCloudName: path.privateCloudName
      - text: Remove the DNS service {dnsServiceId} in {privateCloudName}.
        slots:
          dnsServiceId: path.dnsServiceId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsServices/{dnsServiceId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing DNS service
      effect: write
      questions:
      - Can I change the settings of a DNS service that already exists in my private cloud?
      - Is it possible to patch an existing workload network DNS service?
      instructions:
      - text: Update existing DNS service {dnsServiceId} in {privateCloudName} with {properties}.
        slots:
          dnsServiceId: path.dnsServiceId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      - text: Patch DNS service {dnsServiceId} in private cloud {privateCloudName}.
        slots:
          dnsServiceId: path.dnsServiceId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsZones'].get
  update:
    x-apievangelist-phrasing:
      intent: List DNS zones in an AVS private cloud
      effect: read
      questions:
      - Which DNS zones are defined in my private cloud workload network?
      - Can I see all DNS zones for an Azure VMware Solution private cloud?
      instructions:
      - text: List the DNS zones in private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show every DNS zone in the workload network of {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsZones/{dnsZoneId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one DNS zone
      effect: read
      questions:
      - What are the details of a particular DNS zone in my private cloud?
      - Can I look up a workload network DNS zone by ID?
      instructions:
      - text: Get DNS zone {dnsZoneId} in private cloud {privateCloudName}.
        slots:
          dnsZoneId: path.dnsZoneId
          privateCloudName: path.privateCloudName
      - text: Show the configuration of DNS zone {dnsZoneId} in {privateCloudName}.
        slots:
          dnsZoneId: path.dnsZoneId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsZones/{dnsZoneId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a new DNS zone
      effect: write
      questions:
      - How do I add a new DNS zone to my AVS workload network?
      - Can I create a DNS zone with an ID I choose in a private cloud?
      instructions:
      - text: Create a new DNS zone {dnsZoneId} in private cloud {privateCloudName}.
        slots:
          dnsZoneId: path.dnsZoneId
          privateCloudName: path.privateCloudName
      - text: Add DNS zone {dnsZoneId} to {privateCloudName} with properties {properties}.
        slots:
          dnsZoneId: path.dnsZoneId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsZones/{dnsZoneId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DNS zone
      effect: destructive
      questions:
      - Can I remove a DNS zone from my private cloud workload network?
      - What's needed to delete a workload network DNS zone by its ID?
      instructions:
      - text: Delete DNS zone {dnsZoneId} from private cloud {privateCloudName}.
        slots:
          dnsZoneId: path.dnsZoneId
          privateCloudName: path.privateCloudName
      - text: Remove the DNS zone {dnsZoneId} in {privateCloudName}.
        slots:
          dnsZoneId: path.dnsZoneId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/workloadNetworks/default/dnsZones/{dnsZoneId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing DNS zone
      effect: write
      questions:
      - Can I change the domains or servers on a DNS zone that already exists?
      - Is there a way to patch an existing DNS zone in my private cloud?
      instructions:
      - text: Update existing DNS zone {dnsZoneId} in {privateCloudName} with {properties}.
        slots:
          dnsZoneId: path.dnsZoneId
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      - text: Patch DNS zone {dnsZoneId} in private cloud {privateCloudName}.
        slots:
          dnsZoneId: path.dnsZoneId
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'