php s3 创建bucket,创建 Bucket

描述

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

请求

语法

POST /mkbucketv3//region/ HTTP/1.1

Host: rs.qbox.me

Content-Type: application/x-www-form-urlencoded

Authorization: Qiniu

使用说明：

如果请求的 Bucket 已经存在/重名，返回错误码 614，错误信息：目标资源已存在。

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

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

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

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

请求参数

参数名称

必填

说明

BucketName

是

空间名称，要求在七牛云对象存储范围内唯一，由3～63个字符组成，支持小写字母、短划线-和数字，且必须以小写字母或数字开头和结尾。

Region

否

存储区域，默认华东

z0 华东

z1 华北

z2 华南

na0 北美

as0 东南亚

请求头

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

请求元素

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

响应

响应头

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

响应元素

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

特殊错误

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

示例

请求示例

POST /mkbucketv3/mybucketforvideo HTTP/1.1

Host: rs.qbox.me

User-Agent: Go-http-client/1.1

Content-Length: 0

Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:nP7NSSyGo4x3W_nJ8T9X1gJrgpk=

响应示例

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-Reqid: SFkAAAC8BDebTtsU

{}