更新时间:2024-03-05 GMT+08:00

获取桶列表

功能介绍

OBS用户可以通过请求查询自己创建的桶列表。

请求消息样式

1
2
3
4
GET / HTTP/1.1 
Host: obs.region.example.com
Date: date
Authorization: authorization

请求消息参数

该请求消息中不带请求参数。

请求消息头

该操作消息头与普通请求一样,请参见表3,但可以带附加消息头,附加请求消息头如下所示。

表1 附加请求消息头

消息头名称

描述

是否必选

x-obs-bucket-type

通过此消息头明确获取的列表内容。

取值:

  • OBJECT:获取所有桶列表。
  • POSIX:获取所有并行文件系统列表。

不带此消息头则获取所有桶和并行文件系统列表。

类型:String

示例:x-obs-bucket-type: POSIX

请求消息元素

该请求消息中不带请求元素。

响应消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
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.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> 

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

响应消息元素

该请求的响应消息中,会以XML形式将用户拥有的桶列出来,元素的具体含义如表2所示。

表2 响应消息元素

元素名称

描述

ListAllMyBucketsResult

用户的桶列表。

类型:XML

Owner

桶拥有者信息,包含租户ID。

类型:XML

ID

用户的DomainID(账号ID)。

类型:String

Buckets

用户所拥有的桶列表。

类型:XML

Bucket

具体的桶信息。

类型:XML

Name

桶名称。

类型:String

CreationDate

桶的创建时间。

类型:String

Location

桶的位置信息。

类型:String

错误响应消息

该请求无特殊错误,所有错误已经包含在表2中。

请求示例

1
2
3
4
5
6
GET / HTTP/1.1
User-Agent: curl/7.29.0
Host: obs.region.example.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
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.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>