docs/en/integrations/cloud-storage/tools/cloud-storage-get-object-metadata.md
A cloud-storage-get-object-metadata tool returns metadata for a single
Cloud Storage object. Use it when the LLM needs fields such as
object name, size, content type, generation, storage class, timestamps, checksums,
or custom metadata without reading the object's content.
The response is the object metadata structure returned by the Cloud Storage API.
You can set bucket in the tool configuration. When set, bucket is removed
from the runtime parameter schema and the configured bucket is always used. A
configured bucket must be a non-empty string.
{{< compatible-sources >}}
| parameter | type | required | description |
|---|---|---|---|
| bucket | string | true | Name of the Cloud Storage bucket containing the object. |
| object | string | true | Full object name (path) within the bucket, e.g. path/to/file.txt. |
kind: tool
name: get_object_metadata
type: cloud-storage-get-object-metadata
source: my-gcs-source
description: Use this tool to inspect metadata for a Cloud Storage object.
kind: tool
name: get_app_object_metadata
type: cloud-storage-get-object-metadata
source: my-gcs-source
description: Use this tool to inspect metadata for objects in the application bucket.
bucket: my-app-bucket
The tool returns object metadata from the Cloud Storage API, including fields
such as Name, Bucket, Size, ContentType, Updated, StorageClass,
MD5, CRC32C, and user-defined metadata when present.
| field | type | required | description |
|---|---|---|---|
| type | string | true | Must be "cloud-storage-get-object-metadata". |
| source | string | true | Name of the Cloud Storage source to get object metadata from. |
| description | string | true | Description of the tool that is passed to the LLM. |
| bucket | string | false | Bucket to always inspect objects from. When set, the runtime bucket parameter is hidden. Must not be empty. |