# 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 DnsManagementClient Dnssec Configs API
  version: 1.0.0
extends: openapi/microsoft-azure-dnssecconfigs-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/dnssecConfigs/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DNS zone's DNSSEC configuration
      effect: read
      questions:
      - Is DNSSEC signing configured on my DNS zone?
      - What does the DNSSEC setup of a zone look like?
      instructions:
      - text: Get the DNSSEC configuration for zone {zoneName}.
        slots:
          zoneName: path.zoneName
      - text: Show DNSSEC settings of {zoneName}.
        slots:
          zoneName: path.zoneName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/dnssecConfigs/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable DNSSEC on a DNS zone
      effect: write
      questions:
      - How do I turn on DNSSEC signing for an Azure DNS zone?
      - Can I make enabling DNSSEC conditional on an etag match?
      instructions:
      - text: Enable DNSSEC on zone {zoneName}.
        slots:
          zoneName: path.zoneName
      - text: Create or update DNSSEC config on {zoneName} only if etag matches {If-Match}.
        slots:
          zoneName: path.zoneName
          If-Match: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/dnssecConfigs/default'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove DNSSEC from a DNS zone
      effect: destructive
      questions:
      - Can I turn off DNSSEC signing on a zone, and is it reversible?
      - What happens when I delete a zone's DNSSEC configuration?
      instructions:
      - text: Disable DNSSEC on zone {zoneName}.
        slots:
          zoneName: path.zoneName
      - text: Delete the DNSSEC config of {zoneName} if its etag is {If-Match}.
        slots:
          zoneName: path.zoneName
          If-Match: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/dnssecConfigs'].get
  update:
    x-apievangelist-phrasing:
      intent: List DNSSEC configurations in a zone
      effect: read
      questions:
      - Which DNSSEC configurations exist on a DNS zone?
      - Can I list all DNSSEC configs for a zone rather than fetching the default one?
      instructions:
      - text: List DNSSEC configurations in zone {zoneName}.
        slots:
          zoneName: path.zoneName
      - text: Enumerate every DNSSEC config attached to {zoneName}.
        slots:
          zoneName: path.zoneName
      method: generated
      generated: '2026-09-26'