Getting an Object Storage Bucket's Details

View the details of an Object Storage bucket.

On the Buckets list page, select the Object Storage bucket that you want to work with. If you need help finding the list page or the bucket, see Listing Buckets.

The Details tab shows the following details about the bucket organized by category:
General
- Namespace: The namespace to which the bucket belongs.
- Compartment: The compartment to which the bucket belongs.
- Created: The timestamp of bucket creation.
- ETag: The entity tag (ETag) for the bucket.
- OCID: The Oracle Cloud ID for the bucket.
Features
- Default storage tier: The type of storage tier such as Standard or Archive.
- Visibility: Displays whether the bucket is a private or public bucket. See Changing an Object Storage Bucket's Visibility.
- Encryption key: The master encryption key name assigned to the bucket.
- Auto-tiering: Displays whether auto-tiering is enabled or disabled. See Managing Auto-Tiering for an Object Storage Bucket.
- Emit object events: Displays whether the option to emit objects events is enabled or disabled. See Managing Emitting Events for Object State Changes in an Object Storage Bucket.
- Object versioning: Displays whether object versioning is enabled or disabled. See Managing Object Versioning in an Object Storage Bucket.
Usage
- Approximate count: Approximate number of objects in the bucket.
- Approximate size: Approximate total size of all the objects.
- Uncommitted multipart uploads approximate count: The approximate number of objects with uncommitted or failed multipart uploads.
- Uncommitted multipart uploads approximate size: The total approximate size of the uncommitted multipart uploads in the bucket. If this size exceeds the threshold, a warning icon is displayed.

Use the oci os bucket get command and required parameters to get the details of a bucket:

oci os bucket get --name bucket_name [OPTIONS]

For example:

oci os bucket get --name MyBucket
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": null,
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "7b7c3dc1-713f-4996-b176-a938345cae8e",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "MyBucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,					
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess",
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2020-06-22T19:04:05.879000+00:00",
    "versioning": "Disabled"
  },
  "etag": "7b7c3dc1-713f-4996-b176-a938345cae8e"
}

For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

Viewing Bucket Size and Number of Objects in the Bucket

Use the fields parameter and its supported values to get information on the count and size of objects contained in a bucket.

approximateCount is the approximate number of objects in the bucket. Count statistics are reported periodically. You might see a lag between what is displayed and the actual object count.
approximateSize is the approximate total size of all objects in the bucket. Size statistics are reported periodically. You might see a lag between what is displayed and the actual size of the bucket.

For example:

oci os bucket get --name bucket_name --fields approximateCount --fields approximateSize [OPTIONS]

For example:

oci os bucket get --name MyBucket --fields approximateCount --fields approximateSize
{
  "data": {
    "approximate-count": 25,
    "approximate-size": 8075918,
    "auto-tiering": null,
    "compartment-id": "ocid1.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1:user:oc1:phx:1458751937789:exampleuniqueID",
    "defined-tags": {},
    "etag": "218f201f-28a4-434d-9591-f05b6223c67a",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "MyBucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,
    "object-level-audit-mode": "Disabled",
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess",
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2017-10-19T04:11:32.040000+00:00",
    "versioning": "Disabled"
  },
  "etag": "218f201f-28a4-434d-9591-f05b6223c67a"
}

Run the GetBucket operation to get the details of a bucket.

When accessing the Object Storage API, the bucket name is used with the Object Storage namespace name to form the request URL:
```
n/object_storage_namespace/b/bucket
```

Oracle Cloud Infrastructure Documentation

Getting an Object Storage Bucket's Details

General

Features

Usage

Viewing Bucket Size and Number of Objects in the Bucket