所有文档

          对象存储 BOS

          PutBucket

          接口描述

          本接口用于创建Bucket。每一个用户只允许创建100个Bucket。创建的Bucket其权限默认为private,即Bucket Owner获得FULL_CONTROL,其他人没有任何权限。

          请求(Request)

          • 请求语法

                PUT / HTTP/1.1
                Host: <BucketName>.bj.bcebos.com
                Date: <Date>
                Authorization: <AuthorizationString>
                Content-Length: <ContentLength>
                Content-Type: text/plain
          • 请求头域

            无特殊Header参数

          • 请求参数

            名称 类型 描述 是否必须
            enableMultiAZ Boolean 指定创建的Bucket中数据是否多AZ分布,达到机房级别的数据容灾,true代表创建多AZ bucket,默认为false代表创建。

          响应(Response)

          • 响应头域

            无特殊Header参数返回

          • 响应元素

          注意事项

          • 若一个用户创建的Bucket超过100个,服务将返回400 Bad Request,错误码TooManyBuckets。
          • 若请求的Bucket已存在,无论该Bucket是否是请求者创建,都会返回409 Conflict,错误信息:BucketAlreadyExists。
          • 创建数据多AZ分布的bucket的前提是该region已经支持创建多AZ的bucket,目前BOS仅支持北京和广州两个region,其它region待开通中。

          示例

          • 请求示例

               PUT / HTTP/1.1
               Host: <BucketName>.bj.bcebos.com
               Date: Wed, 06 Apr 2016 06:34:40 GMT
               Authorization: <AuthorizationString>
               Content-Type:text/plain
               Content-Length: 0
               
               {
                   "enableMultiAz":true,
               }
          • 响应示例

               HTTP/1.1 200 OK
               x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
               Date: Wed, 06 Apr 2016 06:34:40 GMT
               Location: bj
               Content-Length: 0
               Connection: close
               Server: BceBos
          上一篇
          Service相关接口
          下一篇
          DeleteBucket