# 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 Bucket API
  version: 1.0.0
extends: openapi/google-cloud-logging-bucket-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: 3
- target: $.paths['/v2/{name}/bucket'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a Cloud Logging log bucket
      effect: read
      questions:
      - What retention period and lifecycle state does one of my log buckets have?
      - Can I check whether a specific log bucket is locked in Google Cloud Logging?
      - Where do I see the details of a single log bucket by its resource name?
      instructions:
      - text: Show me the settings of log bucket {name}.
        slots:
          name: path.name
      - text: Tell me how many days log bucket {name} keeps logs and whether it is locked.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/{name}/bucket'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a log bucket
      effect: destructive
      questions:
      - Can I remove a log bucket I no longer need?
      - What happens to a log bucket when I delete it through the API?
      instructions:
      - text: Delete log bucket {name}.
        slots:
          name: path.name
      - text: Remove the unused log bucket {name} from my project.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/{name}/bucket'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a log bucket's retention or settings
      effect: write
      questions:
      - Can I change how long an existing log bucket retains logs?
      - Is it possible to lock a log bucket so its retention can't be changed?
      - Which fields of an existing bucket can I update using an update mask?
      instructions:
      - text: Set the retention of log bucket {name} to {retentionDays} days.
        slots:
          name: path.name
          retentionDays: requestBody.retentionDays
      - text: Lock log bucket {name} so its retention settings are frozen.
        slots:
          name: path.name
      - text: Update the description of existing log bucket {name} to {description}.
        slots:
          name: path.name
          description: requestBody.description
      method: generated
      generated: '2026-10-01'