接口描述

本接口列举了请求者拥有的所有bucket。

请求（Request）

• 请求语法

  Plain Text 复制

  1GET / HTTP/1.1
  2Host: bj.bcebos.com
  3Date: <Date>
  4Authorization: <AuthorizationString>

• 请求头域

  无特殊参数

• 请求参数

  无特殊参数

响应（Response）

• 响应头域

  无特殊Header参数响应

• 响应元素

  名称	类型	描述
  owner	Object	Bucket owner（拥有者）信息
  +id	String	Bucket owner的用户id
  +displayName	String	Bucket owner的名称
  buckets	Array	存放多个bucket信息的容器
  +bucket	Object	存放一个bucket信息的容器
  +name	String	Bucket名称
  +location	String	Bucket所在区域
  +creationDate	Date	Bucket创建时间
  +enableMultiAz	Boolean	Bucket数据是否多AZ分布，非多AZ bucket不返回该属性

  注意: 如果请求中没有用户验证信息（即匿名访问），返回403 Forbidden，错误信息：AccessDenied。

示例

• JSON请求示例

  说明：一次请求最多返回100个bucket的信息。

  JSON 复制

  1GET / HTTP/1.1
  2Host: bj.bcebos.com
  3Date: Wed, 06 Apr 2016 06:34:40 GMT
  4Authorization: AuthorizationString

• JSON请求响应示例

  JSON 复制

  1{
  2    "owner":{
  3        "id":"10eb6f5ff6ff4605bf044313e8f3ffa5",
  4        "displayName":"BosUser"
  5    },
  6    "buckets":[
  7        {
  8            "name":"bucket1",
  9            "location":"bj",
  10            "creationDate":"2016-04-05T10:20:35Z",
  11            "enableMultiAz":true
  12        },
  13        {
  14            "name":"bucket2",
  15            "location":"bj",
  16            "creationDate":"2016-04-05T16:41:58Z"
  17        }
  18    ]
  19}

说明： JSON请求响应项的命名规则是首字母小写的驼峰格式。