# 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 Network Links API
  version: 1.0.0
extends: openapi/microsoft-azure-virtualnetworklinks-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/virtualNetworkLinks/{virtualNetworkLinkName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a VNet link on a DNS forwarding ruleset
      effect: read
      questions:
      - How do I see which VNet is linked to my DNS forwarding ruleset?
      - What properties does a DNS resolver ruleset's virtual network link have?
      instructions:
      - text: Get VNet link {virtualNetworkLinkName} on forwarding ruleset {dnsForwardingRulesetName}.
        slots:
          virtualNetworkLinkName: path.virtualNetworkLinkName
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
      - text: Show ruleset {dnsForwardingRulesetName} link {virtualNetworkLinkName}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          virtualNetworkLinkName: path.virtualNetworkLinkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/virtualNetworkLinks/{virtualNetworkLinkName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Link a VNet to a DNS forwarding ruleset
      effect: write
      questions:
      - How do I attach a virtual network to a DNS forwarding ruleset?
      - Can I avoid overwriting an existing ruleset link with If-None-Match?
      instructions:
      - text: Link a VNet to forwarding ruleset {dnsForwardingRulesetName} as {virtualNetworkLinkName}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          virtualNetworkLinkName: path.virtualNetworkLinkName
      - text: Create ruleset link {virtualNetworkLinkName} on {dnsForwardingRulesetName} with properties {properties}.
        slots:
          virtualNetworkLinkName: path.virtualNetworkLinkName
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/virtualNetworkLinks/{virtualNetworkLinkName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink a VNet from a DNS forwarding ruleset
      effect: destructive
      questions:
      - Can I detach a VNet from a DNS forwarding ruleset?
      - Is removing a forwarding ruleset's VNet link reversible?
      instructions:
      - text: Delete VNet link {virtualNetworkLinkName} from forwarding ruleset {dnsForwardingRulesetName}.
        slots:
          virtualNetworkLinkName: path.virtualNetworkLinkName
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
      - text: Remove ruleset {dnsForwardingRulesetName} link {virtualNetworkLinkName} only if etag is {ifMatch}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          virtualNetworkLinkName: path.virtualNetworkLinkName
          ifMatch: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/virtualNetworkLinks/{virtualNetworkLinkName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a VNet link on a DNS forwarding ruleset
      effect: write
      questions:
      - Can I change the metadata on an existing forwarding ruleset VNet link?
      - What can be patched on a DNS resolver ruleset's virtual network link?
      instructions:
      - text: Update ruleset link {virtualNetworkLinkName} on {dnsForwardingRulesetName} with {properties}.
        slots:
          virtualNetworkLinkName: path.virtualNetworkLinkName
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          properties: requestBody.properties
      - text: Patch forwarding ruleset {dnsForwardingRulesetName} VNet link {virtualNetworkLinkName}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          virtualNetworkLinkName: path.virtualNetworkLinkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/virtualNetworkLinks'].get
  update:
    x-apievangelist-phrasing:
      intent: List VNet links on a DNS forwarding ruleset
      effect: read
      questions:
      - Which virtual networks use a given DNS forwarding ruleset?
      - Can I cap how many ruleset VNet links come back?
      instructions:
      - text: List VNet links on forwarding ruleset {dnsForwardingRulesetName}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
      - text: Show the first {top} links on ruleset {dnsForwardingRulesetName}.
        slots:
          top: query.$top
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/virtualNetworkLinks/{virtualNetworkLinkName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a VNet link on a Private DNS zone
      effect: read
      questions:
      - Where do I check a virtual network link on my Private DNS zone?
      - Is auto-registration turned on for a private zone's VNet link?
      instructions:
      - text: Get VNet link {virtualNetworkLinkName} on private zone {privateZoneName}.
        slots:
          virtualNetworkLinkName: path.virtualNetworkLinkName
          privateZoneName: path.privateZoneName
      - text: Show Private DNS zone {privateZoneName} link {virtualNetworkLinkName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          privateZoneName: path.privateZoneName
          virtualNetworkLinkName: path.virtualNetworkLinkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/virtualNetworkLinks/{virtualNetworkLinkName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Link a VNet to a Private DNS zone
      effect: write
      questions:
      - How do I link a virtual network to a Private DNS zone so it can resolve records?
      - Can I create a private zone link in a specific location with tags?
      instructions:
      - text: Link a VNet to Private DNS zone {privateZoneName} as {virtualNetworkLinkName}.
        slots:
          privateZoneName: path.privateZoneName
          virtualNetworkLinkName: path.virtualNetworkLinkName
      - text: Create private zone link {virtualNetworkLinkName} on {privateZoneName} in {resourceGroupName} of subscription {subscriptionId} with {properties}.
        slots:
          virtualNetworkLinkName: path.virtualNetworkLinkName
          privateZoneName: path.privateZoneName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/virtualNetworkLinks/{virtualNetworkLinkName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink a VNet from a Private DNS zone
      effect: destructive
      questions:
      - What happens to auto-registered records when I remove a private zone's VNet link?
      - How do I unlink a virtual network from a Private DNS zone?
      instructions:
      - text: Delete VNet link {virtualNetworkLinkName} from private zone {privateZoneName}.
        slots:
          virtualNetworkLinkName: path.virtualNetworkLinkName
          privateZoneName: path.privateZoneName
      - text: Remove Private DNS zone {privateZoneName} link {virtualNetworkLinkName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          privateZoneName: path.privateZoneName
          virtualNetworkLinkName: path.virtualNetworkLinkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/virtualNetworkLinks/{virtualNetworkLinkName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a VNet link on a Private DNS zone
      effect: write
      questions:
      - Can I switch auto-registration on for an existing private zone VNet link?
      - Which tags are on a Private DNS zone's virtual network link, and can I replace them?
      instructions:
      - text: Update private zone link {virtualNetworkLinkName} on {privateZoneName} with {properties}.
        slots:
          virtualNetworkLinkName: path.virtualNetworkLinkName
          privateZoneName: path.privateZoneName
          properties: requestBody.properties
      - text: Set tags {tags} on Private DNS zone {privateZoneName} link {virtualNetworkLinkName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          privateZoneName: path.privateZoneName
          virtualNetworkLinkName: path.virtualNetworkLinkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/virtualNetworkLinks'].get
  update:
    x-apievangelist-phrasing:
      intent: List VNet links on a Private DNS zone
      effect: read
      questions:
      - Which virtual networks are linked to my Private DNS zone?
      - Can I limit how many private zone links are returned?
      instructions:
      - text: List VNet links on private zone {privateZoneName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          privateZoneName: path.privateZoneName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the first {top} links on Private DNS zone {privateZoneName}.
        slots:
          top: query.$top
          privateZoneName: path.privateZoneName
      method: generated
      generated: '2026-09-26'