# 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 Forwarding…
  version: 1.0.0
extends: openapi/microsoft-azure-forwarding-rules-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/forwardingRules/{forwardingRuleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DNS forwarding rule
      effect: read
      questions:
      - What domain and target DNS servers does a forwarding rule use?
      - Where can I read one rule in a DNS forwarding ruleset?
      instructions:
      - text: Get forwarding rule {rule} in DNS forwarding ruleset {ruleset}.
        slots:
          rule: path.forwardingRuleName
          ruleset: path.dnsForwardingRulesetName
      - text: Show the properties of rule {rule} from ruleset {ruleset}.
        slots:
          rule: path.forwardingRuleName
          ruleset: path.dnsForwardingRulesetName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/forwardingRules/{forwardingRuleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a DNS forwarding rule
      effect: write
      questions:
      - How do I forward a domain's DNS queries to my on-premises servers with Private Resolver?
      - Can I create a forwarding rule only if it does not already exist?
      instructions:
      - text: Create forwarding rule {rule} in DNS forwarding ruleset {ruleset} with properties {properties}.
        slots:
          rule: path.forwardingRuleName
          ruleset: path.dnsForwardingRulesetName
          properties: requestBody.properties
      - text: Add rule {rule} to ruleset {ruleset} only if none exists, If-None-Match {if_none_match}.
        slots:
          rule: path.forwardingRuleName
          ruleset: path.dnsForwardingRulesetName
          if_none_match: header.If-None-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/forwardingRules/{forwardingRuleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DNS forwarding rule
      effect: destructive
      questions:
      - How do I delete a rule from a DNS forwarding ruleset?
      - Can a deleted forwarding rule be recovered?
      instructions:
      - text: Delete forwarding rule {rule} from DNS forwarding ruleset {ruleset}.
        slots:
          rule: path.forwardingRuleName
          ruleset: path.dnsForwardingRulesetName
      - text: Permanently remove rule {rule} from ruleset {ruleset} if its etag is {etag}.
        slots:
          rule: path.forwardingRuleName
          ruleset: path.dnsForwardingRulesetName
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/forwardingRules/{forwardingRuleName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a DNS forwarding rule
      effect: write
      questions:
      - Can I change the target DNS servers on an existing forwarding rule?
      - How do I disable a forwarding rule without deleting it?
      instructions:
      - text: Update forwarding rule {rule} in DNS forwarding ruleset {ruleset} with properties {properties}.
        slots:
          rule: path.forwardingRuleName
          ruleset: path.dnsForwardingRulesetName
          properties: requestBody.properties
      - text: Patch rule {rule} in ruleset {ruleset} guarded by etag {etag}.
        slots:
          rule: path.forwardingRuleName
          ruleset: path.dnsForwardingRulesetName
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/forwardingRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List forwarding rules in a DNS ruleset
      effect: read
      questions:
      - Which forwarding rules are defined in my DNS forwarding ruleset?
      - Can I cap how many forwarding rules come back?
      instructions:
      - text: List forwarding rules in DNS forwarding ruleset {ruleset}.
        slots:
          ruleset: path.dnsForwardingRulesetName
      - text: Show the first {top} rules in ruleset {ruleset}.
        slots:
          top: query.$top
          ruleset: path.dnsForwardingRulesetName
      method: generated
      generated: '2026-10-01'