文档首页/ 对象存储服务 OBS/ API参考（吉隆坡区域）/ API/ 桶的基础操作/ 获取桶列表
更新时间：2024-03-05 GMT+08:00
查看PDF
分享

获取桶列表

功能介绍

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>
父主题： 桶的基础操作