Listing Buckets
Functions
You can perform this operation to list all buckets that you have created across all regions.
Request Syntax
GET / HTTP/1.1Host: obs.region.example.comDate: dateAuthorization: authorization
Regardless of the endpoint you specified, a list of buckets spanning all regions is returned.
When creating a bucket, do not list buckets.
Request Parameters
This request contains no parameters.
Request Headers
The operation message header is the same as that of a common request. For details, see Table 3. However, this request can contain additional headers. The following table describes the additional headers for this request.
Header | Description | Mandatory (Yes/No) |
---|---|---|
x-obs-bucket-type | This header field is used to specify the content to be obtained. Value:
If this header is not carried, the list of all buckets and parallel file systems is obtained. Example: x-obs-bucket-type: POSIX | No |
Request Elements
The request does not use request elements.
Response Syntax
GET HTTP/1.1 status_codeContent-Type: typeDate: dateContent-Length: length<?xml version="1.0" encoding="UTF-8" standalone="yes"?><ListAllMyBucketsResult xmlns="http://obs.region.example.com/doc/2015-06-30/"><Owner><ID>id</ID></Owner><Buckets><Bucket><Name>bucketName</Name><CreationDate>date</CreationDate><Location>region</Location></Bucket>...</Buckets></ListAllMyBucketsResult>
Response Headers
The response to the request uses common headers. For details, see Table 1.
Response Elements
This response contains the XML list of buckets owned by the user. Table 2 describes the elements.
Element | Description |
---|---|
ListAllMyBucketsResult | List of buckets created by the user Type: XML |
Owner | Bucket owner information, including the tenant ID. Type: XML |
ID | Domain ID (account ID) of a user. Type: string |
Buckets | Buckets owned by the user Type: XML |
Bucket | Details about a bucket Type: XML |
Name | Bucket name Type: string |
CreationDate | Creation time of the bucket Type: string |
Location | Location of the bucket Type: string |
Error Responses
No special error responses are returned. For details about error responses, see Table 2.
Sample Request
GET /HTTP/1.1User-Agent: curl/7.29.0Host: obs.region.example.comAccept: */*Date: Mon, 25 Jun 2018 05:37:12 +0000Authorization: OBS GKDF4C7Q6SI0IPGTXTJN:9HXkVQIiQKw33UEmyBI4rWrzmic=
Sample Response
HTTP/1.1 200 OKServer: OBSx-obs-request-id: BF260000016435722C11379647A8A00Ax-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSGGDRUM62QZi3hGP8Fz3gOloYCfZ39UContent-Type: application/xmlDate: Mon, 25 Jun 2018 05:37:12 GMTContent-Length: 460<?xml version="1.0" encoding="UTF-8" standalone="yes"?><ListAllMyBucketsResult xmlns="http://obs.example.com/doc/2015-06-30/"><Owner><ID>783fc6652cf246c096ea836694f71855</ID></Owner><Buckets><Bucket><Name>examplebucket01</Name><CreationDate>2018-06-21T09:15:01.032Z</CreationDate><Location>region</Location></Bucket><Bucket><Name>examplebucket02</Name><CreationDate>2018-06-22T03:56:33.700Z</CreationDate><Location>region</Location></Bucket></Buckets></ListAllMyBucketsResult>
- Functions
- Request Syntax
- Request Parameters
- Request Headers
- Request Elements
- Response Syntax
- Response Headers
- Response Elements
- Error Responses
- Sample Request
- Sample Response