# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Analytics Cloud Locations Analytics Cloud Locations Account API
  version: 1.0.0
extends: openapi/adobe-analytics-analytics-cloud-locations-account-api-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/{globalCompanyId}/cloud_locations/exportlocations/account/cloudAccount/s3_role_arn'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the S3 user ARN for role-based S3 accounts
      effect: read
      questions:
      - Which AWS user ARN do I trust when setting up an S3 role ARN cloud account for Adobe Analytics exports?
      - What S3 user ARN does the export service use for the S3 role ARN account type?
      instructions:
      - text: Get the S3 user ARN to put in my IAM role trust policy for an S3 role ARN export account.
      - text: Fetch the Adobe S3 user ARN for the role ARN cloud account type.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/cloud_locations/analytics/exportlocations/account'].get
  update:
    x-apievangelist-phrasing:
      intent: List cloud export location accounts
      effect: read
      questions:
      - What cloud storage accounts are configured for Analytics exports in my company?
      - Can I filter cloud location accounts by type or by who created them?
      instructions:
      - text: List all cloud location accounts for company {globalCompanyId}.
        slots:
          globalCompanyId: path.globalCompanyId
      - text: List {type} cloud location accounts in company {globalCompanyId} created by {createdBy}.
        slots:
          globalCompanyId: path.globalCompanyId
          type: query.type
          createdBy: query.createdBy
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/cloud_locations/analytics/exportlocations/account'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a cloud export location account
      effect: write
      questions:
      - How do I connect a new cloud storage account for delivering Analytics exports?
      - Can I share a new cloud location account with other users when I create it?
      instructions:
      - text: Create a {type} cloud location account named {name} for my Analytics exports.
        slots:
          type: requestBody.type
          name: requestBody.name
      - text: Add a cloud location account called {name} with secret {secret} for exports.
        slots:
          name: requestBody.name
          secret: requestBody.secret
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/cloud_locations/analytics/exportlocations/account/{UUID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one cloud export location account
      effect: read
      questions:
      - How do I view the settings of one specific cloud location account?
      - What type and properties does a given cloud location account have?
      instructions:
      - text: Show cloud location account {UUID} in company {globalCompanyId}.
        slots:
          globalCompanyId: path.globalCompanyId
          UUID: path.UUID
      - text: Get the type and properties of cloud account {UUID}.
        slots:
          UUID: path.UUID
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/cloud_locations/analytics/exportlocations/account/{UUID}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a cloud export location account
      effect: write
      questions:
      - Can I rotate the secret on an existing cloud location account?
      - How do I rename or re-share a cloud location account I already set up?
      instructions:
      - text: Update the secret on cloud location account {UUID} in company {globalCompanyId} to {secret}.
        slots:
          globalCompanyId: path.globalCompanyId
          UUID: path.UUID
          secret: requestBody.secret
      - text: Rename cloud location account {UUID} to {name}.
        slots:
          UUID: path.UUID
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/cloud_locations/analytics/exportlocations/account/{UUID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a cloud export location account
      effect: destructive
      questions:
      - How do I remove a cloud storage account I no longer export Analytics data to?
      - Can I delete a cloud location account by its UUID?
      instructions:
      - text: Delete cloud location account {UUID} from company {globalCompanyId}.
        slots:
          globalCompanyId: path.globalCompanyId
          UUID: path.UUID
      - text: Remove the cloud storage account {UUID} used for exports.
        slots:
          UUID: path.UUID
      method: generated
      generated: '2026-10-01'