docs/en/integrations/cloud-storage/tools/cloud-storage-get-bucket-metadata.md
A cloud-storage-get-bucket-metadata tool returns metadata for a single Cloud
Storage bucket. Use it when the LLM needs fields such as location, storage
class, labels, lifecycle configuration, or uniform bucket-level access status.
The response is the bucket metadata structure returned by the Cloud Storage API.
{{< compatible-sources >}}
The Cloud Storage credentials must be able to read metadata for the target bucket.
| parameter | type | required | description |
|---|---|---|---|
| bucket | string | true | Name of the Cloud Storage bucket to inspect. |
kind: tool
name: get_bucket_metadata
type: cloud-storage-get-bucket-metadata
source: my-gcs-source
description: Use this tool to inspect metadata for a Cloud Storage bucket.
The tool returns bucket metadata from the Cloud Storage API, including fields
such as Name, Location, StorageClass, Created, Labels,
VersioningEnabled, Lifecycle, and UniformBucketLevelAccess.
| field | type | required | description |
|---|---|---|---|
| type | string | true | Must be "cloud-storage-get-bucket-metadata". |
| source | string | true | Name of the Cloud Storage source to get bucket metadata from. |
| description | string | true | Description of the tool that is passed to the LLM. |