# 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 Local Rulestacks…
  version: 1.0.0
extends: openapi/microsoft-azure-localrulestacks-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: 16
- target: $.paths['/subscriptions/{subscriptionId}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List local rulestacks across a subscription
      effect: read
      questions:
      - Which Cloud NGFW local rulestacks exist anywhere in my subscription?
      - Can I get a subscription-wide list of Palo Alto local rulestacks?
      instructions:
      - text: List every local rulestack in my subscription.
      - text: Show all Cloud NGFW local rulestacks across every resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List local rulestacks in a resource group
      effect: read
      questions:
      - What local rulestacks are defined in this resource group?
      - How do I scope the Cloud NGFW rulestack list to one resource group?
      instructions:
      - text: List the local rulestacks in this resource group.
      - text: Show Cloud NGFW rulestacks for the current resource group only.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a local rulestack
      effect: read
      questions:
      - How do I view the settings of one Cloud NGFW local rulestack?
      - What does a specific local rulestack's configuration contain?
      instructions:
      - text: Get local rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Show the configuration of rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a local rulestack
      effect: write
      questions:
      - How do I create a new local rulestack for a Palo Alto Cloud NGFW firewall?
      - Can I attach a managed identity when I create a rulestack?
      instructions:
      - text: Create local rulestack {localRulestackName} with properties {properties}.
        slots:
          localRulestackName: path.localRulestackName
          properties: requestBody.properties
      - text: Create rulestack {localRulestackName} using identity {identity}.
        slots:
          localRulestackName: path.localRulestackName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a local rulestack
      effect: destructive
      questions:
      - How do I remove a local rulestack I no longer use?
      - Can a Cloud NGFW local rulestack be deleted through the API?
      instructions:
      - text: Delete local rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Remove the rulestack named {localRulestackName} permanently.
        slots:
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing local rulestack
      effect: write
      questions:
      - Can I change tags on a rulestack that already exists?
      - How do I patch just some properties of an existing local rulestack?
      instructions:
      - text: Update tags on existing rulestack {localRulestackName} to {tags}.
        slots:
          localRulestackName: path.localRulestackName
          tags: requestBody.tags
      - text: Patch properties {properties} on rulestack {localRulestackName}.
        slots:
          properties: requestBody.properties
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/commit'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit pending rulestack changes
      effect: write
      questions:
      - How do I push my rule edits live on a Cloud NGFW rulestack?
      - Do rulestack changes take effect before I commit them?
      instructions:
      - text: Commit the configuration of rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Apply pending rule changes on {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/getChangeLog'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a rulestack's changelog
      effect: read
      questions:
      - What has changed on my rulestack recently?
      - Where can I see the change history of a local rulestack?
      instructions:
      - text: Get the changelog for rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Show recent configuration changes on {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/getSupportInfo'].post
  update:
    x-apievangelist-phrasing:
      intent: Get support information for a rulestack
      effect: read
      questions:
      - What support details do I need to open a ticket about my rulestack?
      - Can I look up rulestack support info for a specific contact email?
      instructions:
      - text: Get support info for rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Fetch support details for {localRulestackName} for user {email}.
        slots:
          localRulestackName: path.localRulestackName
          email: query.email
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/listAdvancedSecurityObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: List advanced security objects on a rulestack
      effect: read
      questions:
      - Which advanced security objects are available to a rulestack?
      - Can I page through advanced security objects of one type only?
      instructions:
      - text: List advanced security objects of type {type} on rulestack {localRulestackName}.
        slots:
          type: query.type
          localRulestackName: path.localRulestackName
      - text: Show the first {top} {type} security objects for {localRulestackName}.
        slots:
          top: query.top
          type: query.type
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/listAppIds'].post
  update:
    x-apievangelist-phrasing:
      intent: List application IDs usable in rulestack rules
      effect: read
      questions:
      - Which App-IDs can I reference in a rulestack rule?
      - Can I filter the application ID list by a name prefix?
      instructions:
      - text: List App-IDs available to rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Find App-IDs starting with {appPrefix} for {localRulestackName}.
        slots:
          appPrefix: query.appPrefix
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/listCountries'].post
  update:
    x-apievangelist-phrasing:
      intent: List countries available for geo rules
      effect: read
      questions:
      - Which countries can I use in rulestack geo-blocking rules?
      - Is there a list of country codes supported by a rulestack?
      instructions:
      - text: List the countries available to rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Show the first {top} countries I can target in {localRulestackName}.
        slots:
          top: query.top
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/listFirewalls'].post
  update:
    x-apievangelist-phrasing:
      intent: List firewalls using a rulestack
      effect: read
      questions:
      - Which firewalls are using this local rulestack?
      - Before I change a rulestack, how do I see what firewalls it affects?
      instructions:
      - text: List the firewalls associated with rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Show which firewalls depend on {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/listPredefinedUrlCategories'].post
  update:
    x-apievangelist-phrasing:
      intent: List predefined URL categories for a rulestack
      effect: read
      questions:
      - What built-in URL categories can a rulestack filter on?
      - Are there predefined web categories I can block without building my own?
      instructions:
      - text: List predefined URL categories for rulestack {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      - text: Show {top} built-in URL categories available in {localRulestackName}.
        slots:
          top: query.top
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/listSecurityServices'].post
  update:
    x-apievangelist-phrasing:
      intent: List security services for a rulestack
      effect: read
      questions:
      - What security services, like anti-spyware or vulnerability profiles, can a rulestack use?
      - Can I list rulestack security services of one type?
      instructions:
      - text: List security services of type {type} for rulestack {localRulestackName}.
        slots:
          type: query.type
          localRulestackName: path.localRulestackName
      - text: Show the {type} security profiles available on {localRulestackName}.
        slots:
          type: query.type
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/PaloAltoNetworks.Cloudngfw/localRulestacks/{localRulestackName}/revert'].post
  update:
    x-apievangelist-phrasing:
      intent: Discard uncommitted rulestack changes
      effect: destructive
      questions:
      - How do I throw away rulestack edits I haven't committed?
      - Can I roll a rulestack back to its last committed configuration?
      instructions:
      - text: Revert rulestack {localRulestackName} to its committed configuration.
        slots:
          localRulestackName: path.localRulestackName
      - text: Discard pending changes on {localRulestackName}.
        slots:
          localRulestackName: path.localRulestackName
      method: generated
      generated: '2026-09-26'