Skip to main content

Get Bucket

Retrieves metadata and attributes of a Google Cloud Storage bucket.

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.
  • Bucket Name - The name of the bucket to retrieve information about.

Output​

  • Bucket - The bucket metadata and attributes as an object containing:
    • Created - The creation timestamp of the bucket
    • Name - The name of the bucket
    • StorageClass - The storage class of the bucket
    • UniformBucketAccessLevel - The access control configuration
    • Labels - The labels assigned to the bucket

How It Works​

The Get Bucket node retrieves detailed information about a Google Cloud Storage bucket. When executed, the node:

  1. Validates the provided inputs (GCS Client Id, Bucket Name)
  2. Uses the existing storage client connection
  3. Retrieves the attributes and metadata of the specified bucket
  4. Returns the bucket information as a structured object

Requirements​

  • A valid GCS Client Id from a successful Connect node execution
  • Valid bucket name that exists in Google Cloud Storage
  • Proper permissions to read bucket metadata

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid GCS Client Id
  • Empty or invalid Bucket Name
  • Bucket does not exist
  • Insufficient permissions to access the bucket
  • Google Cloud Storage service errors

Usage Notes​

  • This node is useful for checking bucket properties and configurations
  • The returned information includes creation time, storage class, and access control settings
  • Labels assigned to the bucket are included in the output
  • The output can be used for validation, logging, or conditional processing
  • Make sure the authenticated account has the necessary permissions to read bucket metadata
  • The information retrieved is current at the time of execution
  • This operation is read-only and does not modify the bucket