PUT Bucket

最近更新时间:2019-03-13 18:00:33

功能描述

PUT Bucket 接口请求可以在指定账号下创建一个存储桶。该 API 接口不支持匿名请求,您需要使用带 Authorization 签名认证的请求才能创建新的 Bucket 。创建 存储桶的用户默认成为存储桶的持有者。

说明:

创建存储桶时,如果没有指定访问权限,则默认使用私有读写(private)权限。

请求

请求示例

PUT / HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

Authorization: Auth String(详情请参阅 请求签名 文档)。

请求头

公共头部

该请求操作的实现使用公共请求头,了解公共请求头详情请参阅 公共请求头部 文档。

非公共头部

该请求操作的实现可以使用如下头部信息,如需了解 acl 的相关信息请参阅 ACL 概述 文档。

名称 描述 类型 必选
x-cos-acl 定义 bucket 的 acl 属性。有效值:private,public-read-write,public-read;默认值:private String
x-cos-grant-read 赋予被授权者读的权限。格式:x-cos-grant-read: id="[OwnerUin]" String
x-cos-grant-write 赋予被授权者写的权限。格式:x-cos-grant-write: id="[OwnerUin]" String
x-cos-grant-full-control 赋予被授权者所有的权限。格式:x-cos-grant-full-control: id="[OwnerUin]" String

请求体

该请求的请求体为空。

响应

响应头

公共响应头

该响应使用公共响应头,了解公共响应头详情请参阅 公共响应头部 文档。

特有响应头

该响应无特殊的响应头。

响应体

该响应体返回为空。

错误码

以下描述此请求可能会发生的一些特殊的且常见的错误情况,获取更多关于 COS 的错误码的信息,或者产品所有的错误列表,请查看 错误码 文档。

错误码 HTTP 状态码 描述
BucketAlreadyExists 409 Conflict 当请求创建的 Bucket 已经存在,并且请求创建的用户就是拥有者
InvalidBucketName 400 Bad Request Bucket 的命名不规范 具体原因可参考 message 的描述
InvalidRequest 400 Bad Request Bucket 的命名不规范 具体原因可参考 message 的描述

如果 Bucket 设置的 ACL 不正确,也会导致创建 Bucket 失败,同时会返回 “Failed to set access control authority for the bucket” 的错误信息。具体错误原因,可根据返回的错误码参考 Put Bucket ACL 相关的文档。

实际案例

请求

PUT / HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Thu, 12 Jan 2016 19:12:22 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484708728;32557604728&q-key-time=1484708728;32557604728&q-header-list=host&q-url-param-list=&q-signature=b394a86624cbcc705b11bc6fc505843c5e2dd9c9

响应

HTTP /1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Thu, 12 Jan 2016 19:12:22 GMT
Server: tencent-cos
x-cos-request-id: NTg3ZWRiODJfOWIxZjRlXzZmNDBfMTUz