所有文档

          对象存储 BOS

          ListBuckets

          接口描述

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

          请求(Request)

          • 请求语法

            GET / HTTP/1.1
            Host: bj.bcebos.com
            Date: <Date>
            Authorization: <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创建时间

            注意: 如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

          示例

          • JSON请求示例

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

            GET / HTTP/1.1
            Host: BucketName.bj.bcebos.com
            Date: Wed, 06 Apr 2016 06:34:40 GMT
            Authorization: AuthorizationString
          • JSON请求响应示例

            {
                "owner":{
                    "id":"10eb6f5ff6ff4605bf044313e8f3ffa5",
                    "displayName":"BosUser"
                },
                "buckets":[
                    {
                        "name":"bucket1",
                        "location":"bj",
                        "creationDate":"2016-04-05T10:20:35Z"
                    },
                    {
                        "name":"bucket2",
                        "location":"bj",
                        "creationDate":"2016-04-05T16:41:58Z"
                    }
                ]
            }

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

          上一篇
          DeleteBucket
          下一篇
          ListObjects