# 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 Prefix List…
  version: 1.0.0
extends: openapi/microsoft-azure-prefixlistglobalrulestack-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}/prefixlists'].get
  update:
    x-apievangelist-phrasing:
      intent: List prefix lists in a global rulestack
      effect: read
      questions:
      - Which IP prefix lists are defined in my Cloud NGFW global rulestack?
      - Can I list every prefix list in a tenant-level rulestack?
      instructions:
      - text: List prefix lists in global rulestack {rulestack}.
        slots:
          rulestack: path.globalRulestackName
      - text: Show all IP prefix lists defined on rulestack {rulestack}.
        slots:
          rulestack: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/prefixlists/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a prefix list from a global rulestack
      effect: read
      questions:
      - How do I see the CIDR prefixes in one global rulestack prefix list?
      - What addresses does a named prefix list contain?
      instructions:
      - text: Get prefix list {name} from global rulestack {rulestack}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
      - text: Show the CIDRs in prefix 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}/prefixlists/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a global rulestack prefix list
      effect: write
      questions:
      - How do I add a reusable list of IP prefixes to my global firewall rulestack?
      - Can I replace the prefixes in an existing rulestack prefix list?
      instructions:
      - text: Create prefix list {name} in global rulestack {rulestack} with {properties}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
          properties: requestBody.properties
      - text: Save prefixes {properties} as list {name} on rulestack {rulestack}.
        slots:
          properties: requestBody.properties
          name: path.name
          rulestack: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/prefixlists/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a prefix list from a global rulestack
      effect: destructive
      questions:
      - How do I delete a prefix list from a global rulestack?
      - Can I remove a prefix list that firewall rules no longer use?
      instructions:
      - text: Delete prefix list {name} from global rulestack {rulestack}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
      - text: Remove the unused IP list {name} on rulestack {rulestack}.
        slots:
          name: path.name
          rulestack: path.globalRulestackName
      method: generated
      generated: '2026-09-26'