Listing Buckets
Functions
You can perform this operation to list all buckets that you have created across all regions.
Request Syntax
1 2 3 4 |
GET / HTTP/1.1 Host: obs.region.myhuaweicloud.com Date: date Authorization: authorization |
Regardless of the endpoint you specified, a list of buckets spanning all regions is returned.
Do not list buckets during bucket creation.
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
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
GET HTTP/1.1 status_code Content-Type: type Date: date Content-Length: length <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ListAllMyBucketsResult xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> <Owner> <ID>id</ID> </Owner> <Buckets> <Bucket> <Name>bucketName</Name> <CreationDate>date</CreationDate> <Location>region</Location> <BucketType>buckettype</BucketType> </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 |
BucketType |
Bucket type Type: string
|
Error Responses
No special error responses are returned. For details about error responses, see Table 2.
Sample Request
1 2 3 4 5 6 |
GET / HTTP/1.1 User-Agent: curl/7.29.0 Host: obs.region.myhuaweicloud.com Accept: */* Date: Mon, 25 Jun 2018 05:37:12 +0000 Authorization: OBS GKDF4C7Q6SI0IPGTXTJN:9HXkVQIiQKw33UEmyBI4rWrzmic= |
Sample Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016435722C11379647A8A00A x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSGGDRUM62QZi3hGP8Fz3gOloYCfZ39U Content-Type: application/xml Date: Mon, 25 Jun 2018 05:37:12 GMT Content-Length: 460 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ListAllMyBucketsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.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> <BucketType>OBJECT</BucketType> </Bucket> <Bucket> <Name>examplebucket02</Name> <CreationDate>2018-06-22T03:56:33.700Z</CreationDate> <Location>region</Location> <BucketType>OBJECT</BucketType> </Bucket> </Buckets> </ListAllMyBucketsResult> |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot