列举存储桶
更新时间：2021-12-29
接口说明
本接口列举了请求者拥有的所有bucket
注意
- 如果请求中没有用户验证信息（即匿名访问），返回
403 Forbidden，错误信息：AccessDenied。- JSON请求响应项的命名规则是首字母小写的驼峰格式。
- 一次请求最多返回100个bucket的信息。
请求URI
GET /v1
请求体参数
请求体字段数据结构说明
响应体参数
响应体字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| owner | Owner | Bucket owner（拥有者）信息 | |
| buckets | List<Buckets> | 存放多个bucket信息的容器 |
Owner字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| id | String | Bucket owner的用户id | 10eb6f5ff6ff4605bf044313e8f3ffa5 |
| displayName | String | Bucket owner的名称 | BosUser |
Buckets字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| name | String | Bucket名称 | bucket2 |
| location | String | Bucket所在区域 | bj |
| creationDate | String | Bucket创建时间 | 2016-04-05T16:41:58Z |
| enableMultiAz | Boolean | Bucket数据是否多AZ分布，非多AZ bucket不返回该属性 | true |
请求示例
JSON
1GET /v1
2<公共请求头>
3
4
5{ }响应示例
JSON
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "owner" : {
6 "displayName" : "BosUser",
7 "id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
8 },
9 "buckets" : [ {
10 "name" : "bucket2",
11 "location" : "bj",
12 "creationDate" : "2016-04-05T16:41:58Z",
13 "enableMultiAz" : true
14 }, {
15 "name" : "bucket2",
16 "location" : "bj",
17 "creationDate" : "2016-04-05T16:41:58Z",
18 "enableMultiAz" : true
19 } ]
20}错误码
请参考通用错误码