Cloud Storage Bucket

Docs > DDSQL Reference > Data Directory > Cloud Storage Bucket

A Cloud Storage Bucket in GCP is a scalable container for storing objects such as files, images, and backups. It provides durable, highly available storage with options for different storage classes to balance cost and performance. Buckets support fine-grained access control, lifecycle management, and integration with other Google Cloud services, making them suitable for both active data and long-term archival.

gcp.storage_bucket

Fields

ID	Type	Data Type	Description
_key	core	string
acl	core	json	Access controls on the bucket.
ancestors	core	array<string>
autoclass	core	json	The bucket's Autoclass configuration.
billing	core	json	The bucket's billing configuration.
cors	core	json	The bucket's Cross-Origin Resource Sharing (CORS) configuration.
custom_placement_config	core	json	The bucket's custom placement configuration for Custom Dual Regions.
datadog_display_name	core	string
default_event_based_hold	core	bool	The default value for event-based hold on newly created objects in this bucket. Event-based hold is a way to retain objects indefinitely until an event occurs, signified by the hold's release. After being released, such objects will be subject to bucket-level retention (if any). One sample use case of this flag is for banks to hold loan documents for at least 3 years after loan is paid in full. Here, bucket-level retention is 3 years and the event is loan being paid in full. In this example, these objects will be held intact for any number of years until the event has occurred (event-based hold on the object is released) and then 3 more years after that. That means retention duration of the objects begins from the moment event-based hold transitioned from true to false. Objects under event-based hold cannot be deleted, overwritten or archived until the hold is removed.
default_object_acl	core	json	Default access controls to apply to new objects when no ACL is provided.
encryption	core	json	Encryption configuration for a bucket.
etag	core	string	HTTP 1.1 Entity tag for the bucket.
iam_configuration	core	json	The bucket's IAM configuration.
id	core	string	The ID of the bucket. For buckets, the id and name properties are the same.
kind	core	string	The kind of item this is. For buckets, this is always storage#bucket.
labels	core	array<string>	User-provided labels, in key/value pairs.
lifecycle	core	json	The bucket's lifecycle configuration. See [Lifecycle Management](https://cloud.google.com/storage/docs/lifecycle) for more information.
location	core	string	The location of the bucket. Object data for objects in the bucket resides in physical storage within this region. Defaults to US. See the [Developer's Guide](https://cloud.google.com/storage/docs/locations) for the authoritative list.
location_type	core	string	The type of the bucket location.
logging	core	json	The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.
metageneration	core	int64	The metadata generation of this bucket.
name	core	string	The name of the bucket.
organization_id	core	string
owner	core	json	The owner of the bucket. This is always the project team's owner group.
parent	core	string
project_id	core	string
project_number	core	string	The project number of the project the bucket belongs to.
resource_name	core	string
retention_policy	core	json	The bucket's retention policy. The retention policy enforces a minimum retention time for all objects contained in the bucket, based on their creation time. Any attempt to overwrite or delete objects younger than the retention period will result in a PERMISSION_DENIED error. An unlocked retention policy can be modified or removed from the bucket via a storage.buckets.update operation. A locked retention policy cannot be removed or shortened in duration for the lifetime of the bucket. Attempting to remove or decrease period of a locked retention policy will result in a PERMISSION_DENIED error.
rpo	core	string	The Recovery Point Objective (RPO) of this bucket. Set to ASYNC_TURBO to turn on Turbo Replication on a bucket.
satisfies_pzs	core	bool	Reserved for future use.
self_link	core	string	The URI of this bucket.
storage_class	core	string	The bucket's default storage class, used whenever no storageClass is specified for a newly-created object. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include MULTI_REGIONAL, REGIONAL, STANDARD, NEARLINE, COLDLINE, ARCHIVE, and DURABLE_REDUCED_AVAILABILITY. If this value is not specified when the bucket is created, it will default to STANDARD. For more information, see [Storage Classes](https://cloud.google.com/storage/docs/storage-classes).
tags	core	hstore
time_created	core	timestamp	The creation time of the bucket in RFC 3339 format.
updated	core	timestamp	The modification time of the bucket in RFC 3339 format.
versioning	core	json	The bucket's versioning configuration.
website	core	json	The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site. See the [Static Website Examples](https://cloud.google.com/storage/docs/static-website) for more information.