# 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 (OCI and Alibaba) API
  version: 1.0.0
extends: openapi/palo-alto-networks-cloud-accounts-oci-and-alibaba-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: 5
- target: $.paths['/cloud/oci/terraform'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate the OCI onboarding Terraform script
      effect: write
      questions:
      - How do I get a Terraform script to onboard my Oracle Cloud tenancy to Prisma Cloud?
      - Can the OCI Terraform template generate API keys for me?
      instructions:
      - text: Generate an OCI Terraform zip for account {accountId} with user {userName}, group {groupName} and policy {policyName}.
        slots:
          accountId: requestBody.accountId
          userName: requestBody.userName
          groupName: requestBody.groupName
          policyName: requestBody.policyName
      - text: 'Build the Oracle Cloud onboarding Terraform for tenancy {accountId}, generating keys: {generateKeys}.'
        slots:
          accountId: requestBody.accountId
          generateKeys: requestBody.generateKeys
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/status/{cloud_type}'].post
  update:
    x-apievangelist-phrasing:
      intent: Trial-run OCI or Alibaba account onboarding
      effect: read
      questions:
      - Can I validate my Oracle Cloud or Alibaba Cloud parameters before adding the account?
      - What status messages come back from an onboarding trial run?
      instructions:
      - text: Run an onboarding trial for a {cloud_type} account.
        slots:
          cloud_type: path.cloud_type
      - text: Check the onboarding status messages for my {cloud_type} cloud account.
        slots:
          cloud_type: path.cloud_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}'].post
  update:
    x-apievangelist-phrasing:
      intent: Onboard an OCI or Alibaba cloud account
      effect: write
      questions:
      - How do I add an Oracle Cloud or Alibaba Cloud account to Prisma Cloud?
      - Can I skip status checks while onboarding an OCI account?
      instructions:
      - text: Onboard a new {cloud_type} cloud account.
        slots:
          cloud_type: path.cloud_type
      - text: Add a {cloud_type} account with skipStatusChecks {skipStatusChecks}.
        slots:
          cloud_type: path.cloud_type
          skipStatusChecks: query.skipStatusChecks
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud/{cloud_type}/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an OCI or Alibaba cloud account
      effect: write
      questions:
      - How do I change the settings of an Oracle Cloud account already onboarded?
      - Can I update an Alibaba Cloud account's information?
      instructions:
      - text: Update {cloud_type} account {id}.
        slots:
          cloud_type: path.cloud_type
          id: path.id
      - text: 'Modify the onboarded {cloud_type} cloud account {id} without status checks: {skipStatusChecks}.'
        slots:
          cloud_type: path.cloud_type
          id: path.id
          skipStatusChecks: query.skipStatusChecks
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cas/v1/cloud/{cloudType}/deployment-type'].get
  update:
    x-apievangelist-phrasing:
      intent: List Alibaba cloud deployment types
      effect: read
      questions:
      - Which deployment types can I choose when onboarding an Alibaba Cloud account?
      - What deployment type options exist for my cloud account?
      instructions:
      - text: List deployment types for cloud {cloudType}.
        slots:
          cloudType: path.cloudType
      - text: Show the available {cloudType} account deployment types.
        slots:
          cloudType: path.cloudType
      method: generated
      generated: '2026-09-26'