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
Key | Datatype | Required | Description |
---|---|---|---|
fields | string | Bucket 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
Key | Datatype | Required | Description |
---|---|---|---|
if-match | string | The 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-match | string | The 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-id | string | The client request ID for tracing. | |
Accept | string |
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"}