cloud-storage-get-bucket-iam-policy

A “cloud-storage-get-bucket-iam-policy” tool returns IAM policy bindings for a Cloud Storage bucket.

About

A cloud-storage-get-bucket-iam-policy tool returns the IAM policy bindings for a Cloud Storage bucket. Use it to inspect which principals have roles on a bucket without modifying access.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to read the IAM policy for the target bucket.

Parameters

parametertyperequireddescription
bucketstringtrueName of the Cloud Storage bucket whose IAM policy should be returned.

Example

kind: tool
name: get_bucket_iam_policy
type: cloud-storage-get-bucket-iam-policy
source: my-gcs-source
description: Use this tool to inspect IAM bindings for a Cloud Storage bucket.

Output Format

The tool returns a JSON object with:

fieldtypedescription
bucketstringCloud Storage bucket whose policy was read.
bindingsarrayIAM bindings with role, members, and optional condition fields.

Reference

fieldtyperequireddescription
typestringtrueMust be “cloud-storage-get-bucket-iam-policy”.
sourcestringtrueName of the Cloud Storage source to get bucket IAM policies from.
descriptionstringtrueDescription of the tool that is passed to the LLM.