# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Google Cloud Logging Buckets API
  version: 1.0.0
extends: openapi/google-cloud-logging-buckets-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: 2
- target: $.paths['/v2/{parent}/buckets'].get
  update:
    x-apievangelist-phrasing:
      intent: List log buckets in a project or location
      effect: read
      questions:
      - Which log buckets exist in my Google Cloud project?
      - Can I page through all the log buckets under a location?
      - What buckets is my organization storing logs in?
      instructions:
      - text: List all log buckets under {parent}.
        slots:
          parent: path.parent
      - text: Show the first {pageSize} log buckets in {parent}.
        slots:
          parent: path.parent
          pageSize: query.pageSize
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/{parent}/buckets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new log bucket
      effect: write
      questions:
      - Can I create a separate log bucket with its own retention period?
      - What do I need to set up a new bucket for storing logs?
      - Is there a way to make a custom log bucket for one team's logs?
      instructions:
      - text: Create a log bucket called {bucketId} under {parent}.
        slots:
          bucketId: query.bucketId
          parent: path.parent
      - text: Create log bucket {bucketId} in {parent} that keeps logs for {retentionDays} days.
        slots:
          bucketId: query.bucketId
          parent: path.parent
          retentionDays: requestBody.retentionDays
      method: generated
      generated: '2026-10-01'