List Buckets
GET {{baseUrl}}/n/:namespaceName/b/?compartmentId={{compartment_ocid}}&limit=154
Gets a list of all BucketSummary items in a compartment. A BucketSummary contains only summary fields for the bucket and does not contain fields like the user-defined metadata.
ListBuckets returns a BucketSummary containing at most 1000 buckets. To paginate through more buckets, use the returned
opc-next-page value with the page request parameter.
To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized, talk to an administrator. If you are an administrator who needs to write policies to give users access, see Getting Started with Policies.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
compartmentId | string | (Required) The ID of the compartment in which to list buckets. | |
limit | number | For list pagination. The maximum number of results per page, or items to return in a paginated | |
| "List" call. For important details about how pagination works, see | |||
| List Pagination. | |||
page | string | For list pagination. The value of the opc-next-page response header from the previous "List" call. For important | |
| details about how pagination works, see List Pagination. | |||
fields | string | Bucket summary in list of buckets includes the 'namespace', 'name', 'compartmentId', 'createdBy', 'timeCreated', | |
| and 'etag' fields. This parameter can also include 'tags' (freeformTags and definedTags). The only supported value of this parameter is 'tags' for now. Example 'tags'. | |||
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
opc-client-request-id | string | The client request ID for tracing. | |
Accept | string |
RESPONSES
status: OK
[{"compartmentId":"culpa Excepteu","createdBy":"id eiusmod nulla","etag":"dolor adipisicing eu","name":"do tempor","namespace":"est et","timeCreated":"2015-11-16T17:43:35.730Z","definedTags":{"in4":{"cupidatatb":{},"mollitb3d":{},"quis_7c3":{}},"deserunt_4":{"ade":{},"irure_b":{}},"none":{"Duis3":{},"pariatur__8f":{}}},"freeformTags":{"ut_2a":"do ipsum dolore","sint_":"veniam laborum et tempor"}},{"compartmentId":"dolo","createdBy":"eu id aliqua","etag":"in amet","name":"consectetur occaecat","namespace":"laboris est ea in","timeCreated":"1953-08-23T04:02:51.131Z","definedTags":{"culpa78":{"esse9":{},"Excepteurf4_":{}},"ut_3":{"quisc31":{},"consequat_656":{}}},"freeformTags":{"enim7f":"officia qui"}}]