# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Palo Alto Networks Cloud Accounts (GCP) API
  version: 1.0.0
extends: openapi/palo-alto-networks-cloud-accounts-gcp-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: 9
- target: $.paths['/cas/v1/cloud_account/status/gcp'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a GCP account's onboarding status
      effect: read
      questions:
      - Will my GCP project onboard cleanly into Prisma Cloud with the security features I picked?
      - Can I verify GCP credentials and capabilities before actually adding the account?
      instructions:
      - text: Check the onboarding status of GCP account {cloudAccount} using credentials {credentials} and default account group {defaultAccountGroupId}.
        slots:
          cloudAccount: requestBody.cloudAccount
          credentials: requestBody.credentials
          defaultAccountGroupId: requestBody.defaultAccountGroupId
      - text: Dry-run the GCP onboarding checks for {cloudAccount}.
        slots:
          cloudAccount: requestBody.cloudAccount
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cas/v1/gcp_account'].post
  update:
    x-apievangelist-phrasing:
      intent: Onboard a GCP account to Prisma Cloud
      effect: write
      questions:
      - How do I connect a new GCP project or organization to Prisma Cloud?
      - Can I skip the status checks when onboarding a GCP account?
      instructions:
      - text: Onboard GCP account {cloudAccount} with credentials {credentials} into account group {defaultAccountGroupId}.
        slots:
          cloudAccount: requestBody.cloudAccount
          credentials: requestBody.credentials
          defaultAccountGroupId: requestBody.defaultAccountGroupId
      - text: Add GCP organization {organizationName} as a new cloud account.
        slots:
          organizationName: requestBody.organizationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cas/v1/gcp_account/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an onboarded GCP account
      effect: write
      questions:
      - How do I change the settings of a GCP account that's already onboarded?
      - Can I turn on flow log compression for an existing GCP account?
      instructions:
      - text: Update GCP account {id} with new credentials {credentials}.
        slots:
          id: path.id
          credentials: requestBody.credentials
      - text: Change the flow log storage bucket on GCP account {id} to {flowLogStorageBucket}.
        slots:
          id: path.id
          flowLogStorageBucket: requestBody.flowLogStorageBucket
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/gcp/parent/{parent_id}/children'].post
  update:
    x-apievangelist-phrasing:
      intent: List GCP folders and projects under a parent
      effect: read
      questions:
      - What folders and projects sit directly under my GCP organization or folder?
      - Can I page through child projects and child folders separately?
      instructions:
      - text: List both folders and projects under GCP parent {parent_id} of type {parentType}.
        slots:
          parent_id: path.parent_id
          parentType: query.parentType
      - text: Show the children of GCP {parentType} {parent_id}, {projectPageSize} projects per page.
        slots:
          parentType: query.parentType
          parent_id: path.parent_id
          projectPageSize: query.projectPageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/accounts/{account_id}/ancestors'].post
  update:
    x-apievangelist-phrasing:
      intent: List ancestors of GCP projects and folders
      effect: read
      questions:
      - Which folders and organization does a given GCP project roll up to?
      - Can I trace the ancestry of several projects in one call?
      instructions:
      - text: Find the ancestors of resources {resourceIds} in {cloud_type} account {account_id}.
        slots:
          resourceIds: requestBody.resourceIds
          cloud_type: path.cloud_type
          account_id: path.account_id
      - text: Trace the hierarchy above project {resourceIds} for account {account_id} on {cloud_type}.
        slots:
          resourceIds: requestBody.resourceIds
          account_id: path.account_id
          cloud_type: path.cloud_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/accounts/{account_id}/hierarchy'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cloud account's saved resource hierarchy
      effect: read
      questions:
      - What resource hierarchy selection did I save for a cloud account?
      - Which folders and projects were chosen when this account was onboarded?
      instructions:
      - text: Show the saved hierarchy for {cloud_type} account {account_id}.
        slots:
          cloud_type: path.cloud_type
          account_id: path.account_id
      - text: Get the previously stored resource hierarchy of account {account_id} on {cloud_type}.
        slots:
          account_id: path.account_id
          cloud_type: path.cloud_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/parent/{parent_id}/folders'].post
  update:
    x-apievangelist-phrasing:
      intent: List only the child folders of a parent
      effect: read
      questions:
      - What folders exist under my GCP organization, without the projects?
      - Can I page through subfolders of a folder?
      instructions:
      - text: List child folders only under {cloud_type} parent {parent_id} of type {parentType}.
        slots:
          cloud_type: path.cloud_type
          parent_id: path.parent_id
          parentType: query.parentType
      - text: Show {pageSize} subfolders of {parentType} {parent_id} on {cloud_type}.
        slots:
          pageSize: query.pageSize
          parentType: query.parentType
          parent_id: path.parent_id
          cloud_type: path.cloud_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/parent/{parent_id}/projects'].post
  update:
    x-apievangelist-phrasing:
      intent: List only the child projects of a parent
      effect: read
      questions:
      - Which GCP projects live under a specific folder, excluding subfolders?
      - Can I paginate the projects that belong to my organization?
      instructions:
      - text: List child projects only under {cloud_type} parent {parent_id} of type {parentType}.
        slots:
          cloud_type: path.cloud_type
          parent_id: path.parent_id
          parentType: query.parentType
      - text: Show {pageSize} projects directly inside {parentType} {parent_id} on {cloud_type}.
        slots:
          pageSize: query.pageSize
          parentType: query.parentType
          parent_id: path.parent_id
          cloud_type: path.cloud_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cas/v1/gcp_template'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate the GCP onboarding Terraform template
      effect: write
      questions:
      - How do I get the Terraform template with the right permissions to onboard GCP?
      - Does the GCP Terraform template change depending on which features I select?
      instructions:
      - text: Generate a GCP Terraform template for project {projectId} in org {orgId}, account type {accountType}, auth {authenticationType}.
        slots:
          projectId: requestBody.projectId
          orgId: requestBody.orgId
          accountType: requestBody.accountType
          authenticationType: requestBody.authenticationType
      - text: Download the GCP onboarding Terraform for project {projectId} with features {features}.
        slots:
          projectId: requestBody.projectId
          features: requestBody.features
      method: generated
      generated: '2026-09-26'