对象存储

  • 创建 Bucket

    最近更新时间:2017-08-17 16:08:46

    描述

    本接口用于创建一个新的 Bucket。此接口不支持匿名请求。您可以在请求参数中指定存储区域,例如,您在华东,选择华东存储区域可以减少延迟、降低成本。


    请求


    语法

    POST /mkbucketv2/<EncodedBucketName> HTTP/1.1
    Host: rs.qiniu.com
    Content-Type: application/x-www-form-urlencoded
    Authorization: QBox <AccessToken>
    

    使用说明:

    • 如果请求的 Bucket 已经存在,并且设置了 Region 参数,返回 200 OK 成功。

    • 如果请求的 Bucket 已经存在,但没有设置 Region 参数,返回错误码 614,错误信息:目标资源已存在。

    • 如果创建的 Bucket 不符合命名规范,返回错误码 400,错误信息:invalid arguments。

    • 如果发起创建 Bucket 请求的时候,没有传入认证信息,返回错误码 401,错误信息:bad token。

    • 如果创建 Bucket 的时候超过最大创建数(默认 20 个),返回错误码 630,错误信息:too many buckets。

    • 目前 Bucket 有两种访问权限:公开和私有。创建的 Bucket,默认为公有权限。


    请求参数

    参数名称 必填 说明
    EncodeBucketName 空间名称的URL安全的Base64编码,空间名称仅支持字母、短划线-、下划线_、数字的组合。
    Region 存储区域,默认华东
  • z0 华东
  • z1 华北
  • z2 华南
  • na0 北美

  • 请求头

    该请求操作的实现使用了所有操作的公共请求头。有关详细信息,请查阅公共请求头


    请求元素

    该请求操作的请求体为空。


    响应


    响应头

    该请求操作的实现使用了所有操作的公共响应头。有关详细信息,请查阅公共响应头


    响应元素

    该请求操作的响应体为空。


    特殊错误

    该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息,请查阅错误响应


    示例


    请求示例

    POST /mkbucketv2/dGVzdDA2 HTTP/1.1
    Host: rs.qiniu.com
    User-Agent: Go-http-client/1.1
    Content-Length: 0
    Authorization: QBox j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:nP7NSSyGo4x3W_nJ8T9X1gJrgpk=
    Accept-Encoding: gzip
    


    响应示例

    HTTP/1.1 200 OK
    Content-Length: 2
    Connection: keep-alive
    Content-Type: application/json
    Date: Wed, 16 Aug 2017 11:02:11 GMT
    Server: nginx
    X-Log: CFGS:1032;CFGS:274;TBLMGR;CFGS:1145;ONE:1152;AC;DOMAINUNIFYMGR:5;FUSIONLINE:1;fusiondomain:1169;TBLMGR:2484;RS:2485;ZONEPROXY:2486
    X-Reqid: SFkAAAC8BDebTtsU
    
    {}
    
    以上内容是否对您有帮助?
  • 提交工单