GET Bucket

GET {{baseUrl}}/n/:namespaceName/b/:bucketName/?fields=approximateSize,autoTiering

Gets the current representation of the given bucket in the given Object Storage namespace.

Request Params

KeyDatatypeRequiredDescription
fieldsstringBucket summary includes the 'namespace', 'name', 'compartmentId', 'createdBy', 'timeCreated',
and 'etag' fields. This parameter can also include 'approximateCount' (approximate number of objects), 'approximateSize'
(total approximate size in bytes of all objects) and 'autoTiering' (state of auto tiering on the bucket).
For example 'approximateCount,approximateSize,autoTiering'.

HEADERS

KeyDatatypeRequiredDescription
if-matchstringThe entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of
the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload
the resource.
if-none-matchstringThe entity tag (ETag) to avoid matching. Wildcards ('*') are not allowed. If the specified ETag does not
match the ETag of the existing resource, the request returns the expected response. If the ETag matches
the ETag of the existing resource, the request returns an HTTP 304 status without a response body.
opc-client-request-idstringThe client request ID for tracing.
Acceptstring

RESPONSES

status: OK

{"compartmentId":"nisi id proident","createdBy":"minim Lorem occaecat ea","etag":"proident dolor nisi mollit","metadata":{"est_29e":"deserunt proident tempor ut ad","dolor_13a":"deserunt nostrud in","mollite":"eu ullamco"},"name":"elit velit","namespace":"deserunt ut magna","timeCreated":"1959-02-11T07:22:15.304Z","approximateCount":-38707126,"approximateSize":8468883,"autoTiering":"InfrequentAccess","definedTags":{"deserunt_be":{"cupidatat_e8c":{}}},"freeformTags":{"amet376":"in in","Duis5d7":"aliquip mollit","proident_80":"dolor ex","veniam44c":"consectetur quis","fugiat89d":"incididunt sunt offi"},"id":"consequat in esse","isReadOnly":false,"kmsKeyId":"Lorem fugiat aliquip non","objectEventsEnabled":false,"objectLifecyclePolicyEtag":"voluptate labore exercitation","publicAccessType":"NoPublicAccess","replicationEnabled":false,"storageTier":"Archive","versioning":"Suspended"}