列举存储桶
更新时间：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 |
请求示例
GET /v1
<公共请求头>
{ }响应示例
HTTP/1.1 200 OK
<公共响应头>
{
"owner" : {
"displayName" : "BosUser",
"id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
},
"buckets" : [ {
"name" : "bucket2",
"location" : "bj",
"creationDate" : "2016-04-05T16:41:58Z",
"enableMultiAz" : true
}, {
"name" : "bucket2",
"location" : "bj",
"creationDate" : "2016-04-05T16:41:58Z",
"enableMultiAz" : true
} ]
}错误码
请参考通用错误码