API Evangelist conversational phrasing for Microsoft Azure PaloAltoNetworks.Cloudngfw Firewalls API

# 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 Firewalls API
  version: 1.0.0
extends: openapi/microsoft-azure-firewalls-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/providers/PaloAltoNetworks.Cloudngfw/firewalls'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cloud NGFW firewalls in a subscription
      effect: read
      questions:
      - Which Palo Alto Cloud NGFW firewalls are deployed across my whole Azure subscription?
      - How can I inventory every next-generation firewall resource I own?
      instructions:
      - text: List all Cloud NGFW firewalls in my subscription.
      - text: Show every next-gen firewall resource across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cloud NGFW firewalls in a resource group
      effect: read
      questions:
      - What firewalls are running inside one specific resource group?
      - How do I narrow my Cloud NGFW firewall list to a single resource group?
      instructions:
      - text: List the Cloud NGFW firewalls in this resource group.
      - text: Show only the resource group's next-gen firewalls.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls/{firewallName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Cloud NGFW firewall
      effect: read
      questions:
      - How do I view the configuration of one Cloud NGFW firewall?
      - What network and DNS settings does a particular firewall have?
      instructions:
      - text: Get firewall {firewall}.
        slots:
          firewall: path.firewallName
      - text: Show the configuration of Cloud NGFW firewall {firewall}.
        slots:
          firewall: path.firewallName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls/{firewallName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Cloud NGFW firewall
      effect: write
      questions:
      - How do I deploy a new Palo Alto next-generation firewall in Azure?
      - What properties are required when creating a Cloud NGFW firewall resource?
      instructions:
      - text: Create firewall {firewall} with properties {properties}.
        slots:
          firewall: path.firewallName
          properties: requestBody.properties
      - text: Deploy a new Cloud NGFW named {firewall} using managed identity {identity}.
        slots:
          firewall: path.firewallName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls/{firewallName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Cloud NGFW firewall
      effect: destructive
      questions:
      - How do I tear down a Cloud NGFW firewall I no longer need?
      - Can I remove a next-gen firewall resource by name?
      instructions:
      - text: Delete firewall {firewall}.
        slots:
          firewall: path.firewallName
      - text: Decommission the Cloud NGFW firewall named {firewall}.
        slots:
          firewall: path.firewallName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls/{firewallName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Cloud NGFW firewall
      effect: write
      questions:
      - How do I change the tags or identity on an existing firewall without recreating it?
      - Can I patch just some properties of a Cloud NGFW firewall?
      instructions:
      - text: Update the tags on firewall {firewall} to {tags}.
        slots:
          firewall: path.firewallName
          tags: requestBody.tags
      - text: Patch firewall {firewall} with properties {properties}.
        slots:
          firewall: path.firewallName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls/{firewallName}/getGlobalRulestack'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the global rulestack linked to a firewall
      effect: read
      questions:
      - Which global rulestack is associated with my firewall?
      - How do I find the tenant-level rules applied to a Cloud NGFW?
      instructions:
      - text: Get the global rulestack associated with firewall {firewall}.
        slots:
          firewall: path.firewallName
      - text: Show which global rulestack governs Cloud NGFW {firewall}.
        slots:
          firewall: path.firewallName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls/{firewallName}/getLogProfile'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a firewall's log profile
      effect: read
      questions:
      - Where are my firewall's traffic, threat and decryption logs being sent?
      - How can I view the current logging destinations on a Cloud NGFW?
      instructions:
      - text: Get the log profile for firewall {firewall}.
        slots:
          firewall: path.firewallName
      - text: Show where Cloud NGFW {firewall} currently ships its logs.
        slots:
          firewall: path.firewallName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls/{firewallName}/getSupportInfo'].post
  update:
    x-apievangelist-phrasing:
      intent: Get support info for a firewall
      effect: read
      questions:
      - How do I get the support details I need to open a case for my Cloud NGFW?
      - Can I pull firewall support information tied to a specific email address?
      instructions:
      - text: Get support info for firewall {firewall}.
        slots:
          firewall: path.firewallName
      - text: Fetch support details for firewall {firewall} for the user with email {email}.
        slots:
          firewall: path.firewallName
          email: query.email
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/firewalls/{firewallName}/saveLogProfile'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a firewall's log profile
      effect: write
      questions:
      - How do I send my firewall's threat logs to a different destination?
      - Can I route traffic, threat and decryption logs to separate places, or to Application Insights?
      instructions:
      - text: Save a log profile on firewall {firewall} sending logs to {destination}.
        slots:
          firewall: path.firewallName
          destination: requestBody.commonDestination
      - text: Send threat logs from firewall {firewall} to {threat_destination} and traffic logs to {traffic_destination}.
        slots:
          firewall: path.firewallName
          threat_destination: requestBody.threatLogDestination
          traffic_destination: requestBody.trafficLogDestination
      method: generated
      generated: '2026-09-26'