Bucket → Get
AI-generatedOverview
This node interacts with Google Cloud Storage Buckets, specifically supporting the "Get" operation on buckets. It retrieves metadata and configuration details about a specified bucket in Google Cloud Storage. This is useful when you want to programmatically access bucket information such as its properties, access control lists (ACLs), lifecycle rules, labels, and other settings.
Common scenarios include:
- Verifying bucket configurations before performing operations.
- Auditing bucket properties for compliance or monitoring.
- Fetching bucket metadata to use in workflows that manage cloud storage resources.
Example: You might use this node to get the details of a bucket named "my-data-bucket" to check its retention policy or versioning status before uploading new objects.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate with Google Cloud Storage API. Options: Service Account, OAuth2 |
| Bucket Name | The name of the bucket to retrieve information from. |
| Projection | Determines the set of properties returned for the bucket. Options: "All Properties", "No ACL" |
| Filters | Optional filters applied to the request: - Metageneration Match: Return data only if metageneration matches the given number. - Metageneration Exclude: Return data only if metageneration does not match the given number. |
Output
The output is a JSON object containing the bucket's metadata and configuration details as returned by the Google Cloud Storage API. This includes fields such as:
- Bucket name
- Creation date
- Location and storage class
- Access control lists (if projection includes ACL)
- Lifecycle rules
- Labels
- Versioning and retention policies
- Logging configuration
The exact structure depends on the selected projection and filters but generally reflects the full bucket resource representation from Google Cloud Storage.
No binary data is output by this operation.
Dependencies
- Requires valid authentication credentials for Google Cloud Storage, either via a service account or OAuth2.
- Needs proper permissions to access bucket metadata in the Google Cloud project.
- The node uses Google Cloud Storage REST API endpoints under the hood.
- No additional environment variables are explicitly required beyond standard n8n credential setup for Google APIs.
Troubleshooting
Common issues:
- Authentication errors: Ensure the provided credentials have sufficient permissions to access the bucket.
- Bucket not found: Verify the bucket name is correct and exists in the project.
- Metageneration filter mismatches: Using metageneration filters incorrectly may result in no data returned.
Error messages:
- 403 Forbidden: Insufficient permissions; check IAM roles and credentials.
- 404 Not Found: Bucket does not exist or wrong bucket name.
- 400 Bad Request: Invalid parameters, e.g., malformed filters or unsupported projection values.
Resolving these typically involves verifying credentials, bucket names, and parameter correctness.