# 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 PaloAltoNetworks.Cloudngfw Fqdn List Global…
  version: 1.0.0
extends: openapi/microsoft-azure-fqdnlistglobalrulestack-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['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/fqdnlists'].get
  update:
    x-apievangelist-phrasing:
      intent: List FQDN lists on a global rulestack
      effect: read
      questions:
      - Which FQDN lists are defined on my Cloud NGFW global rulestack?
      - How do I see every domain-name list available to tenant-wide firewall rules?
      instructions:
      - text: List the FQDN lists on global rulestack {rulestack}.
        slots:
          rulestack: path.globalRulestackName
      - text: Show every domain-name list defined in rulestack {rulestack}.
        slots:
          rulestack: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/fqdnlists/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an FQDN list from a global rulestack
      effect: read
      questions:
      - What domain names are in a specific FQDN list on my global rulestack?
      - How do I view one FQDN list by name?
      instructions:
      - text: Get FQDN list {name} from global rulestack {rulestack}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
      - text: Show the domains in list {name} on rulestack {rulestack}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/fqdnlists/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an FQDN list on a global rulestack
      effect: write
      questions:
      - How do I add a list of domain names to my global rulestack for use in firewall rules?
      - Can I change the domains in an existing FQDN list?
      instructions:
      - text: Create FQDN list {name} on global rulestack {rulestack} with {properties}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
          properties: requestBody.properties
      - text: Replace the domains in FQDN list {name} of rulestack {rulestack} using {properties}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/fqdnlists/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an FQDN list from a global rulestack
      effect: destructive
      questions:
      - How do I delete an FQDN list that my rules no longer use?
      - Can I remove a domain-name list from a global rulestack?
      instructions:
      - text: Delete FQDN list {name} from global rulestack {rulestack}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
      - text: Remove domain list {name} from rulestack {rulestack}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
      method: generated
      generated: '2026-09-26'