This table represents the Bucket resource from Oracle Cloud Infrastructure.

oci.bucket

Fields

TitleIDTypeData TypeDescription
_keycorestring
approximate_countcoreint64The 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_sizecoreint64The 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_tieringcorestringThe 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_idcorestringThe compartment ID in which the bucket is authorized.
created_bycorestringThe [OCID](/Content/General/Concepts/identifiers.htm) of the user who created the bucket.
etagcorestringThe entity tag (ETag) for the bucket.
idcorestringThe [OCID](/Content/General/Concepts/identifiers.htm) of the bucket.
is_read_onlycoreboolWhether 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_idcorestringThe [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.
namecorestringThe name of the bucket. Avoid entering confidential information.Example: my-new-bucket1
namespacecorestringThe Object Storage namespace in which the bucket resides.
object_events_enabledcoreboolWhether 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_etagcorestringThe entity tag (ETag) for the live object lifecycle policy on the bucket.
public_access_typecorestringThe 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_enabledcoreboolWhether 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_tiercorestringThe 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.
tagscorehstore
tenancy_ocidcorestring
time_createdcoretimestampThe date and time the bucket was created, as described in [RFC 2616](https://tools.ietf.org/html/rfc2616#section-14.29).
versioningcorestringThe 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.