## object.gdc.goog/v1alpha1

Package v1alpha1 contains API Schema definitions for the object.gdc.goog v1alpha1 API group

### Bucket

Bucket is the Schema for the buckets API

*Appears in:*
- [BucketList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/storage-krm-api#bucketlist)

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

### BucketList

BucketList contains a list of Bucket

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

### BucketPolicy

*Appears in:*
- [BucketSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/storage-krm-api#bucketspec)

| Field | Description |
|---|---|
| `lockingPolicy` *[LockingPolicy](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/storage-krm-api#lockingpolicy)* | Policy for object locking. When set, object versioning is enabled and all objects stored in the bucket will be subject to this policy. A locked object cannot be deleted until the lock expires. LockingPolicy has to be enabled when creating the bucket and cannot be disabled afterwards. When unset, object locking and versioning is disabled and cannot be enabled. |

### BucketSpec

BucketSpec defines the desired state of the Bucket Resource.

*Appears in:*
- [Bucket](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/storage-krm-api#bucket)

| Field | Description |
|---|---|
| *description* *string* | Description of bucket contents. |
| *storageClass* *ObjectStorageClass* | Available options are: - Standard - Good for **hot** data that is accessed frequently, including websites, streaming videos, and mobile apps |
| *bucketPolicy* *[BucketPolicy](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/storage-krm-api#bucketpolicy)* | Defines policies of the bucket resource. If unspecified, default policies will be applied. |

### BucketStatus

BucketStatus defines the observed state of Bucket

*Appears in:*
- [Bucket](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/storage-krm-api#bucket)

| Field | Description |
|---|---|
| `fullyQualifiedName` *string* | FullyQualifiedName is the name of the provisioned bucket. This name should be used to refer to the bucket when using external tools and libraries. |
| `conditions` *[Conditions](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/storage-krm-api#conditions)* | Conditions specify the status of the bucket. Supported conditions include: - BucketReady: true indicates if the bucket has been provisioned and is ready for use |
| `endpoint` *string* | The DNS endpoint at which the bucket is reachable. |
| `region` *string* | The region where the bucket is stored. |

### LockingPolicy

LockingPolicy defines the strategy for locking the objects of the bucket.

*Appears in:*
- [BucketPolicy](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/storage-krm-api#bucketpolicy)

| Field | Description |
|---|---|
| `defaultObjectRetentionDays` *integer* | DefaultObjectRetentionDays specifies the minimum number of days that each version of every object will be retained. An object cannot be deleted during the retention period. If a bucket contains any object, it cannot be deleted either. When unspecified, no default object retention period is set. DefaultObjectRetentionDays can be modified after creation, however the change will only take effect for new objects and versions. Existing objects and versions will still use the previous value. |