列举存储桶
所有文档

          对象存储 BOS

          列举存储桶

          接口说明

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

          注意

          1. 如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied
          2. JSON请求响应项的命名规则是首字母小写的驼峰格式。
          3. 一次请求最多返回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
            } ]
          }

          错误码

          请参考通用错误码

          上一篇
          删除存储桶
          下一篇
          列举存储桶下的Object