获取桶列表
功能介绍
OBS用户可以通过请求查询自己创建的所有区域的桶列表。
请求消息样式
1 2 3 4 |
GET / HTTP/1.1 Host: obs.cn-north-4.myhuaweicloud.com Date: date Authorization: authorization |
终端节点(Endpoint)不会限制查询结果,无论哪一个区域的Endpoint,查询结果都是所有区域的桶列表。
创桶期间不要并发列举桶
请求消息参数
该请求消息中不带请求参数。
请求消息头
该操作消息头与普通请求一样,请参见表3,但可以带附加消息头,附加请求消息头如下所示。
消息头名称 |
描述 |
是否必选 |
---|---|---|
x-obs-bucket-type |
通过此消息头明确获取的列表内容。 取值:
不带此消息头则获取所有桶和并行文件系统列表。 示例:x-obs-bucket-type: POSIX |
否 |
请求消息元素
该请求消息中不带请求元素。
响应消息样式
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.cn-north-4.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> |
响应消息头
该请求的响应消息使用公共消息头,具体请参考表1。
响应消息元素
该请求的响应消息中,会以XML形式将用户拥有的桶列出来,元素的具体含义如表2所示。
错误响应消息
该请求无特殊错误,所有错误已经包含在表2中。
请求示例
1 2 3 4 5 6 |
GET / HTTP/1.1 User-Agent: curl/7.29.0 Host: obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Mon, 25 Jun 2018 05:37:12 +0000 Authorization: OBS GKDF4C7Q6SI0IPGTXTJN:9HXkVQIiQKw33UEmyBI4rWrzmic= |
响应示例
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.cn-north-4.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>cn-north-4</Location> <BucketType>OBJECT</BucketType> </Bucket> <Bucket> <Name>examplebucket02</Name> <CreationDate>2018-06-22T03:56:33.700Z</CreationDate> <Location>cn-east-3</Location> <BucketType>OBJECT</BucketType> </Bucket> </Buckets> </ListAllMyBucketsResult> |