Google Cloud Storage · Schema
Bucket
A bucket is a container for objects stored in Cloud Storage. Buckets are associated with a project and have globally unique names.
ArchivalBackupBlob StorageCloud StorageDataFile StorageGoogle CloudObject StorageStorage
Properties
| Name | Type | Description |
|---|---|---|
| kind | string | The kind of item this is. For buckets, this is always storage#bucket. |
| id | string | The ID of the bucket. For buckets, this is the same as the name. |
| selfLink | string | The URI of this bucket. |
| projectNumber | string | The project number of the project the bucket belongs to. |
| name | string | The name of the bucket. Bucket names must be globally unique and conform to naming requirements (3-63 characters, lowercase letters, numbers, hyphens, and dots). |
| timeCreated | string | The creation time of the bucket in RFC 3339 format. |
| updated | string | The modification time of the bucket in RFC 3339 format. |
| metageneration | string | The metadata generation of this bucket. Used for preconditions and for detecting changes in metadata. |
| location | string | The location of the bucket. Object data for objects in the bucket resides in physical storage within this region. |
| locationType | string | The type of location the bucket resides in. |
| storageClass | string | The default storage class of the bucket, used for newly created objects. |
| etag | string | HTTP 1.1 Entity tag for the bucket. |
| defaultEventBasedHold | boolean | Whether or not to automatically apply an event-based hold to new objects added to the bucket. |
| rpo | string | The Recovery Point Objective (RPO) of this bucket. Set to ASYNC_TURBO to turn on Turbo Replication for dual-region buckets. |
| acl | array | Access controls on the bucket. |
| defaultObjectAcl | array | Default access controls to apply to new objects when no ACL is provided. |
| iamConfiguration | object | The bucket's IAM configuration. |
| encryption | object | Encryption configuration for a bucket. |
| lifecycle | object | The bucket's lifecycle configuration. Lifecycle rules automatically manage objects based on conditions. |
| logging | object | The bucket's logging configuration. |
| versioning | object | The bucket's versioning configuration. When enabled, Cloud Storage retains a noncurrent object version when the live object is deleted or overwritten. |
| website | object | The bucket's website configuration for static website hosting. |
| cors | array | The bucket's Cross-Origin Resource Sharing (CORS) configuration. |
| retentionPolicy | object | The bucket's retention policy, which defines the minimum age an object must reach before it can be deleted or replaced. |
| softDeletePolicy | object | The bucket's soft delete policy. |
| autoclass | object | The bucket's Autoclass configuration. Autoclass automatically transitions objects to appropriate storage classes based on access patterns. |
| hierarchicalNamespace | object | The bucket's hierarchical namespace configuration for folder support. |
| labels | object | User-provided labels, in key/value pairs. Keys and values must both be 63 characters or less and must conform to RFC 1035. |
| customPlacementConfig | object | The bucket's custom placement configuration for dual-region buckets. |
| satisfiesPZS | boolean | Whether the bucket satisfies the zone separation requirements for compliance. |