## object.global.gdc.goog/v1

### AsyncDualZoneSpec

*Appears in:*
- [BucketLocationSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationspec)
- [LocationInfo](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#locationinfo)

| Field | Description |
|---|---|
| `zoneNames` *string array* | Slice of 2 location.mz.global.private.gdc.goog/v1alpha1 Zone resources. |
| `combinationPrefix` *string* | 2-character prefix used in the BucketPrefix resource |

### Bucket

Defines the schema for the Buckets API.

*Appears in:*
- [BucketList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `object.global.gdc.goog/v1` |
| `kind` *string* | `Bucket` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[BucketSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketspec)* |   |
| `status` *[BucketStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketstatus)* |   |

### BucketList

Contains a list of Buckets.

| Field | Description |
|---|---|
| `apiVersion` *string* | `object.global.gdc.goog/v1` |
| `kind` *string* | `BucketList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[Bucket](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucket) array* |   |

### BucketLocation

Defines the schema for the BucketLocation API.

*Appears in:*
- [BucketLocationList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `object.global.gdc.goog/v1` |
| `kind` *string* | `BucketLocation` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[BucketLocationSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationspec)* |   |
| `status` *[BucketLocationStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationstatus)* |   |

### BucketLocationClusterStatus

Provides the status of a BucketLocation rolling out to a particular cluster.
Follows pkg/apis/common/global/v1alpha1 ZoneStatus

*Appears in:*
- [BucketLocationConfigStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationconfigstatus)

| Field | Description |
|---|---|
| `name` *string* | The name of the cluster where the replica this status represents is in. |
| `rolloutStatus` *[ZoneRolloutStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#zonerolloutstatus)* | The status of rolling out the replica to the cluster. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | The reconciliation status of the replica collected from the cluster. Any condition within the field that has an .observedGeneration less than .rolloutStatus.replicaGeneration is out of date. |

### BucketLocationConfig

Defines the schema for the BucketLocationConfig API.

*Appears in:*
- [BucketLocationConfigList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationconfiglist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `object.global.gdc.goog/v1` |
| `kind` *string* | `BucketLocationConfig` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[BucketLocationSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationspec)* |   |
| `status` *[BucketLocationConfigStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationconfigstatus)* |   |

### BucketLocationConfigList

Contains a list of BucketLocationConfigs.

| Field | Description |
|---|---|
| `apiVersion` *string* | `object.global.gdc.goog/v1` |
| `kind` *string* | `BucketLocationConfigList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[BucketLocationConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationconfig) array* |   |

### BucketLocationConfigStatus

Defines the observed state of the BucketLocationConfig.

*Appears in:*
- [BucketLocationConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationconfig)

| Field | Description |
|---|---|
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | The observations of the overall state of the resource. Known condition types: Ready. |
| `clusters` *[BucketLocationClusterStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationclusterstatus) array* | The list of cluster statuses where the resource is rolled out to. |

### BucketLocationList

Contains a list of BucketLocations.

| Field | Description |
|---|---|
| `apiVersion` *string* | `object.global.gdc.goog/v1` |
| `kind` *string* | `BucketLocationList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[BucketLocation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocation) array* |   |

### BucketLocationReplica

Defines the schema for the BucketLocationReplica API.

*Appears in:*
- [BucketLocationReplicaList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationreplicalist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `object.global.gdc.goog/v1` |
| `kind` *string* | `BucketLocationReplica` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[BucketLocationSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationspec)* |   |
| `status` *[BucketLocationReplicaStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationreplicastatus)* |   |

### BucketLocationReplicaList

Contains a list of BucketLocationReplicas.

| Field | Description |
|---|---|
| `apiVersion` *string* | `object.global.gdc.goog/v1` |
| `kind` *string* | `BucketLocationReplicaList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[BucketLocationReplica](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationreplica) array* |   |

### BucketLocationReplicaStatus

*Appears in:*
- [BucketLocationReplica](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationreplica)
- [BucketLocationZoneStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationzonestatus)

| Field | Description |
|---|---|
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Conditions represents the observations of this bucket location's overall state. |

### BucketLocationSpec

BucketLocationSpec defines the desired state of the BucketLocation Resource.

*Appears in:*
- [BucketLocation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocation)
- [BucketLocationConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationconfig)
- [BucketLocationReplica](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationreplica)

| Field | Description |
|---|---|
| `asyncDualZone` *[AsyncDualZoneSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#asyncdualzonespec)* | BucketLocation configuration specific to AsyncDualZone buckets. Must be present if LocationType = AsyncDualZone |
| `syncDualZone` *[SyncDualZoneSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#syncdualzonespec)* | BucketLocation configuration specific to SyncDualZone buckets. Must be present if LocationType = SyncDualZone |
| `locationType` *BucketLocationType* | Supported types include: \[ AsyncDualZone, SyncDualZone \]. |
| `active` *boolean* | If active = false, new buckets cannot be created with this BucketLocation. |

### BucketLocationStatus

Defines the observed state of the BucketLocation.

*Appears in:*
- [BucketLocation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocation)

| Field | Description |
|---|---|
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | The observations of the overall state of the resource. Known condition types: Ready. |
| `rollout` *[RolloutStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#rolloutstatus)* | The current strategy used to roll out the resource to each zone. |
| `zones` *[BucketLocationZoneStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationzonestatus) array* | The list of zone statuses where the resource is rolled out to. |

### BucketLocationZoneStatus

Provides the status of a BucketLocation rolling out to a particular zone.

*Appears in:*
- [BucketLocationStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationstatus)

| Field | Description |
|---|---|
| `name` *string* | The name of the zone where the replica this status represents is in. |
| `rolloutStatus` *[ZoneRolloutStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#zonerolloutstatus)* | The status of rolling out the replica to the zone. |
| `replicaStatus` *[BucketLocationReplicaStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationreplicastatus)* | The reconciliation status of the replica collected from the zone. Any condition within the field that has an .observedGeneration less than .rolloutStatus.replicaGeneration is out of date. |

### BucketSpec

Defines the desired state of the Bucket Resource.

*Appears in:*
- [Bucket](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucket)

| Field | Description |
|---|---|
| `description` *string* | The description of bucket contents. |
| `storageClass` *ObjectStorageClass* | The storage class of the bucket. Defines how frequently data needs to be accessed. The available options include `Standard` and `Nearline`. `Standard` is appropriate for hot data that is accessed frequently, such as websites, streaming videos, and mobile apps. It is used for data that can be stored for at least 30 days. `Nearline` is appropriate for data that can be stored for at least 60 days, including data backup and long-tail multimedia content. |
| `bucketPolicy` *GlobalBucketPolicy* | The policies of the bucket resource. If unspecified, default policies are applied. |
| `location` *string* | The physical place where object data in the bucket resides. This must map to the name of an existing `ObjectStorageLocation` resource. |

### BucketStatus

Defines the observed state of the Bucket.

*Appears in:*
- [Bucket](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucket)

| Field | Description |
|---|---|
| `fullyQualifiedName` *string* | The name of the provisioned bucket. This name is used to refer to the bucket when using external tools and libraries. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | The conditions of the bucket. Supported conditions include `BucketReady`. If BucketReady is `True`, it indicates the bucket has been provisioned and is ready for use. |
| `zonalEndpoints` *string array* | Zonal endpoints at which the bucket is reachable. Use these endpoints if a customized failover is required. |
| `globalEndpoint` *string* | Global endpoint which will dynamically route traffic to any zone which contains data for this bucket. Use this endpoint if automatic failover is required. |
| `region` *string* | The region where the bucket is stored. |
| `encryption` *[EncryptionStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#encryptionstatus)* | The status of the encryption on the bucket. |
| `errorStatus` *ErrorStatus* | ErrorStatus holds the most recent errors with the observed times included. |

### LocationInfo

Only one of its members should be specified.

*Appears in:*
- [BucketLocationSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationspec)

| Field | Description |
|---|---|
| `asyncDualZone` *[AsyncDualZoneSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#asyncdualzonespec)* | BucketLocation configuration specific to AsyncDualZone buckets. Must be present if LocationType = AsyncDualZone |
| `syncDualZone` *[SyncDualZoneSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#syncdualzonespec)* | BucketLocation configuration specific to SyncDualZone buckets. Must be present if LocationType = SyncDualZone |

### SyncDualZoneSpec

*Appears in:*
- [BucketLocationSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#bucketlocationspec)
- [LocationInfo](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/storage/v1/global-object-v1#locationinfo)

| Field | Description |
|---|---|
| `zoneNames` *string array* | Slice of 2 location.mz.global.private.gdc.goog/v1alpha1 Zone resources. |
| `combinationPrefix` *string* | 2-character prefix used in the BucketPrefix resource |