# 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 Global Rulestack…
  version: 1.0.0
extends: openapi/microsoft-azure-globalrulestack-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: 14
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List global rulestacks in the tenant
      effect: read
      questions:
      - Which Cloud NGFW global rulestacks exist across my tenant?
      - Can I see every Palo Alto Networks global rulestack I've created, not just one?
      instructions:
      - text: List all global rulestacks in my tenant.
      - text: Show me every Cloud NGFW global rulestack we have.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a global rulestack
      effect: read
      questions:
      - How do I view the configuration of one global rulestack?
      - What settings and provisioning state does a single global rulestack report?
      instructions:
      - text: Show global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Get the details of Cloud NGFW global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a global rulestack
      effect: write
      questions:
      - How do I set up a new tenant-wide rulestack for my Cloud NGFW firewalls?
      - Does creating a global rulestack require a location?
      instructions:
      - text: Create global rulestack {globalRulestackName} in {location}.
        slots:
          globalRulestackName: path.globalRulestackName
          location: requestBody.location
      - text: Create or fully replace global rulestack {globalRulestackName} in region {location} with these properties.
        slots:
          globalRulestackName: path.globalRulestackName
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a global rulestack
      effect: destructive
      questions:
      - What happens to firewalls when I delete a global rulestack?
      - Can I remove a global rulestack I no longer use?
      instructions:
      - text: Delete global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Tear down the Cloud NGFW global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch settings on a global rulestack
      effect: write
      questions:
      - Can I change just the identity or a few properties of an existing global rulestack?
      - How do I modify a global rulestack without recreating it?
      instructions:
      - text: Patch global rulestack {globalRulestackName} with new properties.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Update the managed identity on existing global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/commit'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit pending global rulestack changes
      effect: write
      questions:
      - How do I push my pending rule edits on a global rulestack live to the firewalls?
      - Do rule changes on a global rulestack take effect before I commit them?
      instructions:
      - text: Commit the pending configuration on global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Push staged rule changes live for global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/getChangeLog'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a global rulestack's changelog
      effect: read
      questions:
      - Where can I see what changed recently on a global rulestack?
      - Does the global rulestack changelog show both committed and pending changes?
      instructions:
      - text: Get the changelog for global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Show recent configuration changes on global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/listAdvancedSecurityObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: List a global rulestack's security objects
      effect: read
      questions:
      - Which advanced security objects, like URL or feed objects, does a global rulestack hold?
      - Do I have to specify an object type when listing advanced security objects?
      instructions:
      - text: List advanced security objects of type {type} on global rulestack {globalRulestackName}.
        slots:
          type: query.type
          globalRulestackName: path.globalRulestackName
      - text: Show the first {top} {type} security objects in global rulestack {globalRulestackName}.
        slots:
          top: query.top
          type: query.type
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/listAppIds'].post
  update:
    x-apievangelist-phrasing:
      intent: List App-IDs available to a global rulestack
      effect: read
      questions:
      - What application IDs can I reference in rules on a global rulestack?
      - Can I search App-IDs by prefix or pin them to a specific App-ID version?
      instructions:
      - text: List App-IDs for global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: List App-IDs starting with {appPrefix} in version {appIdVersion} for global rulestack {globalRulestackName}.
        slots:
          appPrefix: query.appPrefix
          appIdVersion: query.appIdVersion
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/listCountries'].post
  update:
    x-apievangelist-phrasing:
      intent: List countries usable in global rulestack rules
      effect: read
      questions:
      - Which country codes can I use for geo-based rules on a global rulestack?
      - Can I page through the country list for a rulestack?
      instructions:
      - text: List the countries available to global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Show {top} countries for geo rules on global rulestack {globalRulestackName}, skipping {skip}.
        slots:
          top: query.top
          globalRulestackName: path.globalRulestackName
          skip: query.skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/listFirewalls'].post
  update:
    x-apievangelist-phrasing:
      intent: List firewalls using a global rulestack
      effect: read
      questions:
      - Which firewalls are attached to a particular global rulestack?
      - Before changing a global rulestack, can I see what firewalls it would affect?
      instructions:
      - text: List the firewalls associated with global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Show which Cloud NGFW firewalls use global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/listPredefinedUrlCategories'].post
  update:
    x-apievangelist-phrasing:
      intent: List predefined URL categories
      effect: read
      questions:
      - What built-in URL categories can a global rulestack filter on?
      - Can I page through the predefined URL category list?
      instructions:
      - text: List predefined URL categories for global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Show the first {top} built-in URL categories on global rulestack {globalRulestackName}.
        slots:
          top: query.top
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/listSecurityServices'].post
  update:
    x-apievangelist-phrasing:
      intent: List security services on a global rulestack
      effect: read
      questions:
      - Which security services, like anti-virus or vulnerability profiles, can a global rulestack use?
      - Do I need to pick a service type when listing security services?
      instructions:
      - text: List security services of type {type} for global rulestack {globalRulestackName}.
        slots:
          type: query.type
          globalRulestackName: path.globalRulestackName
      - text: Show {type} security profiles available on global rulestack {globalRulestackName}.
        slots:
          type: query.type
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/revert'].post
  update:
    x-apievangelist-phrasing:
      intent: Discard uncommitted global rulestack changes
      effect: destructive
      questions:
      - How do I throw away uncommitted edits on a global rulestack?
      - Can I roll a global rulestack back to its last committed configuration?
      instructions:
      - text: Revert global rulestack {globalRulestackName} to its last committed configuration.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Discard pending changes on global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'