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