# 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 Post Rules API
  version: 1.0.0
extends: openapi/microsoft-azure-postrules-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: 7
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/postRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List post rules in a global rulestack
      effect: read
      questions:
      - Which post rules are defined in my Cloud NGFW global rulestack?
      - Can I see all the post rules evaluated after local rules in a tenant-level rulestack?
      instructions:
      - text: List the post rules in global rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      - text: Show every post rule configured on rulestack {globalRulestackName}.
        slots:
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/postRules/{priority}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a post rule by priority
      effect: read
      questions:
      - What does the post rule at a given priority in my global rulestack do?
      - Can I look up a single Cloud NGFW post rule by its priority number?
      instructions:
      - text: Get the post rule at priority {priority} in global rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
      - text: Show post rule {priority} from rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/postRules/{priority}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a post rule
      effect: write
      questions:
      - How do I add a post rule to my Cloud NGFW global rulestack at a specific priority?
      - Can I overwrite an existing post rule's settings at the same priority?
      instructions:
      - text: Create a post rule at priority {priority} in global rulestack {globalRulestackName} with settings {properties}.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
          properties: requestBody.properties
      - text: Update post rule {priority} on rulestack {globalRulestackName} to {properties}.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/postRules/{priority}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a post rule
      effect: destructive
      questions:
      - Can I remove a post rule from my global rulestack?
      - How do I delete the Cloud NGFW post rule at a given priority?
      instructions:
      - text: Delete the post rule at priority {priority} in global rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
      - text: Remove post rule {priority} from rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/postRules/{priority}/getCounters'].post
  update:
    x-apievangelist-phrasing:
      intent: Get hit counters for a post rule
      effect: read
      questions:
      - How many times has a post rule been hit on my firewall?
      - Can I see a post rule's hit counters for one specific firewall?
      instructions:
      - text: Get the hit counters for post rule {priority} in global rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
      - text: Show post rule {priority} hit counts on firewall {firewallName} from rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          firewallName: query.firewallName
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/postRules/{priority}/refreshCounters'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh hit counters for a post rule
      effect: write
      questions:
      - Can I force a post rule's hit counters to update with the latest numbers?
      - What refreshes stale post rule counters for a firewall?
      instructions:
      - text: Refresh the counters of post rule {priority} in global rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
      - text: Refresh post rule {priority} counters on firewall {firewallName} in rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          firewallName: query.firewallName
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/PaloAltoNetworks.Cloudngfw/globalRulestacks/{globalRulestackName}/postRules/{priority}/resetCounters'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset hit counters for a post rule
      effect: destructive
      questions:
      - How do I zero out the hit counters on a post rule?
      - Can I reset a post rule's counters for just one firewall?
      instructions:
      - text: Reset the counters of post rule {priority} in global rulestack {globalRulestackName} to zero.
        slots:
          priority: path.priority
          globalRulestackName: path.globalRulestackName
      - text: Clear post rule {priority} hit counts on firewall {firewallName} in rulestack {globalRulestackName}.
        slots:
          priority: path.priority
          firewallName: query.firewallName
          globalRulestackName: path.globalRulestackName
      method: generated
      generated: '2026-09-26'