---
title: Bucket
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > Bucket
---

# Bucket

This table represents the Bucket resource from Oracle Cloud Infrastructure.

```
oci.bucket
```

## Fields

| Title                        | ID   | Type       | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                             | Description |
| ---------------------------- | ---- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                         | core | string     |
| approximate_count            | core | int64      | The approximate number of objects in the bucket. Count statistics are reported periodically. You will see alag between what is displayed and the actual object count.                                                                                                                                                                                                                                                                                 |
| approximate_size             | core | int64      | The approximate total size in bytes of all objects in the bucket. Size statistics are reported periodically. You willsee a lag between what is displayed and the actual size of the bucket.                                                                                                                                                                                                                                                           |
| auto_tiering                 | core | string     | The auto tiering status on the bucket. A bucket is created with auto tiering `Disabled` by default.For auto tiering `InfrequentAccess`, objects are transitioned automatically between the 'Standard'and 'InfrequentAccess' tiers based on the access pattern of the objects.                                                                                                                                                                         |
| compartment_id               | core | string     | The compartment ID in which the bucket is authorized.                                                                                                                                                                                                                                                                                                                                                                                                 |
| created_by                   | core | string     | The [OCID](/Content/General/Concepts/identifiers.htm) of the user who created the bucket.                                                                                                                                                                                                                                                                                                                                                             |
| etag                         | core | string     | The entity tag (ETag) for the bucket.                                                                                                                                                                                                                                                                                                                                                                                                                 |
| id                           | core | string     | The [OCID](/Content/General/Concepts/identifiers.htm) of the bucket.                                                                                                                                                                                                                                                                                                                                                                                  |
| is_read_only                 | core | bool       | Whether or not this bucket is read only. By default, `isReadOnly` is set to `false`. This willbe set to 'true' when this bucket is configured as a destination in a replication policy.                                                                                                                                                                                                                                                               |
| kms_key_id                   | core | string     | The [OCID](/Content/General/Concepts/identifiers.htm) of a master encryption key used to call the Key Managementservice to generate a data encryption key or to encrypt or decrypt a data encryption key.                                                                                                                                                                                                                                             |
| name                         | core | string     | The name of the bucket. Avoid entering confidential information.Example: my-new-bucket1                                                                                                                                                                                                                                                                                                                                                               |
| namespace                    | core | string     | The Object Storage namespace in which the bucket resides.                                                                                                                                                                                                                                                                                                                                                                                             |
| object_events_enabled        | core | bool       | Whether or not events are emitted for object state changes in this bucket. By default, `objectEventsEnabled` isset to `false`. Set `objectEventsEnabled` to `true` to emit events for object state changes. For more informationabout events, see [Overview of Events](/Content/Events/Concepts/eventsoverview.htm).                                                                                                                                  |
| object_lifecycle_policy_etag | core | string     | The entity tag (ETag) for the live object lifecycle policy on the bucket.                                                                                                                                                                                                                                                                                                                                                                             |
| public_access_type           | core | string     | The type of public access enabled on this bucket.A bucket is set to `NoPublicAccess` by default, which only allows an authenticated caller to access thebucket and its contents. When `ObjectRead` is enabled on the bucket, public access is allowed for the`GetObject`, `HeadObject`, and `ListObjects` operations. When `ObjectReadWithoutList` is enabled on thebucket, public access is allowed for the `GetObject` and `HeadObject` operations. |
| replication_enabled          | core | bool       | Whether or not this bucket is a replication source. By default, `replicationEnabled` is set to `false`. This willbe set to 'true' when you create a replication policy for the bucket.                                                                                                                                                                                                                                                                |
| storage_tier                 | core | string     | The storage tier type assigned to the bucket. A bucket is set to `Standard` tier by default, which meansobjects uploaded or copied to the bucket will be in the standard storage tier. When the `Archive` tier typeis set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage.The `storageTier` property is immutable after bucket is created.                                                        |
| tags                         | core | hstore_csv |
| tenancy_ocid                 | core | string     |
| time_created                 | core | timestamp  | The date and time the bucket was created, as described in [RFC 2616](https://tools.ietf.org/html/rfc2616#section-14.29).                                                                                                                                                                                                                                                                                                                              |
| versioning                   | core | string     | The versioning status on the bucket. A bucket is created with versioning `Disabled` by default.For versioning `Enabled`, objects are protected from overwrites and deletes, by maintaining their version history. When versioning is `Suspended`, the previous versions will still remain but new versions will no longer be created when overwitten or deleted.                                                                                      |
