Skip to main content

List Buckets

Lists all buckets in a Google Cloud Storage project.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • GCS Client Id - The client identifier obtained from the Connect node.
  • Project Id - The Google Cloud project ID to list buckets from.

Output​

  • List - An array of bucket names in the specified project.

How It Works​

The List Buckets node retrieves a list of all buckets in a Google Cloud Storage project. When executed, the node:

  1. Validates the provided inputs (GCS Client Id, Project Id)
  2. Uses the existing storage client connection
  3. Queries Google Cloud Storage for all buckets in the specified project
  4. Returns an array of bucket names

Requirements​

  • A valid GCS Client Id from a successful Connect node execution
  • Valid Google Cloud Project Id
  • Proper permissions to list buckets in the specified project

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid GCS Client Id
  • Empty or invalid Project Id
  • Insufficient permissions to list buckets
  • Google Cloud Storage service errors
  • Operation timeout (after 10 seconds)

Usage Notes​

  • The output is a simple array of bucket names (strings)
  • Only buckets the authenticated account has access to will be listed
  • The operation has a 10-second timeout for safety
  • This node is useful for inventory, validation, or dynamic bucket selection
  • The list includes all buckets regardless of their storage class or configuration
  • Make sure the authenticated account has the necessary permissions to list buckets
  • The returned list can be used with other nodes for batch operations
  • Empty projects will return an empty array