# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Cloud Access Keys API Overview Onboarding AWS S3…
  version: 1.0.0
extends: openapi/palo-alto-networks-onboarding-aws-s3-flow-logs-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: 3
- target: $.paths['/cloud-accounts-manager/v1/cloud-accounts/aws/{accountId}/features/aws-flow-logs/s3'].get
  update:
    x-apievangelist-phrasing:
      intent: Get AWS S3 flow log settings for an account
      effect: read
      questions:
      - Which S3 buckets is a monitored AWS account using for VPC flow logs?
      - How can I see the current S3 flow log configuration for an onboarded AWS account?
      instructions:
      - text: Show the S3 flow log details for AWS account {accountId}.
        slots:
          accountId: path.accountId
      - text: Get the logging accounts and buckets configured for flow logs on {accountId}.
        slots:
          accountId: path.accountId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud-accounts-manager/v1/cloud-accounts/aws/{accountId}/features/aws-flow-logs/s3'].patch
  update:
    x-apievangelist-phrasing:
      intent: Save AWS S3 flow log settings
      effect: write
      questions:
      - How do I tell Prisma Cloud which S3 buckets hold my AWS flow logs?
      - Can I save S3 flow log settings using the hourly log format?
      instructions:
      - text: Save S3 flow log settings for account {accountId} with logging accounts {loggingAccounts}, hourly format {isHourlyFormat}.
        slots:
          accountId: path.accountId
          loggingAccounts: requestBody.loggingAccounts
          isHourlyFormat: query.isHourlyFormat
      - text: 'Configure flow log buckets {loggingAccounts} for AWS account {accountId} (hourly format: {isHourlyFormat}).'
        slots:
          loggingAccounts: requestBody.loggingAccounts
          accountId: path.accountId
          isHourlyFormat: query.isHourlyFormat
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cloud-accounts-manager/v1/cloud-accounts/aws/{accountId}/features/aws-flow-logs/s3/status'].post
  update:
    x-apievangelist-phrasing:
      intent: Check AWS S3 flow log ingestion status
      effect: read
      questions:
      - Are my S3 flow log buckets set up correctly for a monitored AWS account?
      - How do I verify flow log status for specific buckets before saving them?
      instructions:
      - text: Check S3 flow log status for account {accountId} with hourly format {isHourlyFormat}.
        slots:
          accountId: path.accountId
          isHourlyFormat: query.isHourlyFormat
      - text: Verify flow log status of buckets {buckets} in logging account {loggingAccountId} for {accountId}, hourly format {isHourlyFormat}.
        slots:
          buckets: requestBody.buckets
          loggingAccountId: requestBody.loggingAccountId
          accountId: path.accountId
          isHourlyFormat: query.isHourlyFormat
      method: generated
      generated: '2026-09-26'