# 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 DnsResolverManagementClient Dns Forwarding…
  version: 1.0.0
extends: openapi/microsoft-azure-dnsforwardingrulesets-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DNS forwarding ruleset
      effect: read
      questions:
      - What outbound endpoints does my DNS forwarding ruleset use?
      - Can I look up one forwarding ruleset by name?
      instructions:
      - text: Get DNS forwarding ruleset {dnsForwardingRulesetName}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
      - text: Show the properties of forwarding ruleset {dnsForwardingRulesetName}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a DNS forwarding ruleset
      effect: write
      questions:
      - How do I create a ruleset to forward DNS queries from my private resolver?
      - Can I avoid overwriting an existing ruleset by accident when creating one?
      instructions:
      - text: Create DNS forwarding ruleset {dnsForwardingRulesetName} with {properties}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          properties: requestBody.properties
      - text: Create forwarding ruleset {dnsForwardingRulesetName} only if it doesn't exist, using If-None-Match {ifNoneMatch}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          ifNoneMatch: header.If-None-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DNS forwarding ruleset
      effect: destructive
      questions:
      - What happens to the forwarding rules when I delete their ruleset?
      - Can deleting a DNS forwarding ruleset be undone?
      instructions:
      - text: Delete DNS forwarding ruleset {dnsForwardingRulesetName}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
      - text: Delete forwarding ruleset {dnsForwardingRulesetName} only if its etag is {ifMatch}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          ifMatch: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a DNS forwarding ruleset
      effect: write
      questions:
      - How do I retag an existing DNS forwarding ruleset?
      - Can I patch a ruleset's tags without resending its whole definition?
      instructions:
      - text: Set tags on DNS forwarding ruleset {dnsForwardingRulesetName} to {tags}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          tags: requestBody.tags
      - text: Patch ruleset {dnsForwardingRulesetName} tags if its etag matches {ifMatch}.
        slots:
          dnsForwardingRulesetName: path.dnsForwardingRulesetName
          ifMatch: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets'].get
  update:
    x-apievangelist-phrasing:
      intent: List DNS forwarding rulesets in a resource group
      effect: read
      questions:
      - Which DNS forwarding rulesets are in this resource group?
      - Can I cap how many rulesets a resource group listing returns?
      instructions:
      - text: List the DNS forwarding rulesets in my resource group.
      - text: Show the first {top} forwarding rulesets in this resource group.
        slots:
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnsForwardingRulesets'].get
  update:
    x-apievangelist-phrasing:
      intent: List DNS forwarding rulesets across a subscription
      effect: read
      questions:
      - How many DNS forwarding rulesets do I have across all resource groups?
      - Can I see every forwarding ruleset in the subscription at once?
      instructions:
      - text: List all DNS forwarding rulesets in my subscription.
      - text: Show up to {top} forwarding rulesets across every resource group.
        slots:
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/listDnsForwardingRulesets'].post
  update:
    x-apievangelist-phrasing:
      intent: List DNS forwarding rulesets linked to a virtual network
      effect: read
      questions:
      - Which forwarding rulesets are attached to my virtual network?
      - Is any DNS forwarding ruleset linked to a given VNet?
      instructions:
      - text: List DNS forwarding rulesets attached to virtual network {virtualNetworkName}.
        slots:
          virtualNetworkName: path.virtualNetworkName
      - text: Show up to {top} ruleset IDs linked to VNet {virtualNetworkName}.
        slots:
          top: query.$top
          virtualNetworkName: path.virtualNetworkName
      method: generated
      generated: '2026-09-26'