PutBucket接口用于创建存储空间(Bucket)。

说明
  • 此接口不支持匿名访问。
  • 一个用户在同一地域(Region)内最多可创建30个Bucket。
  • 每个地域都有对应的访问域名(Endpoint),地域与访问域名的对应关系参见访问域名和数据中心

请求语法

PUT / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
x-oss-acl: Permission
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>

请求头

名称 类型 是否必选 描述
x-oss-acl 字符串

指定Bucket访问权限。

有效值:public-read-writepublic-readprivate

说明 如果创建的 Bucket 没有指定访问权限,则默认使用private权限。

请求元素

名称 类型 是否必选 描述
StorageClass 字符串

指定Bucket存储类型。

有效值:StandardIAArchive

DataRedundancyType 字符串

指定Bucket的数据容灾类型。

有效值:
  • LRS(本地容灾类型,默认值)
  • ZRS(同城容灾类型)

示例

请求示例
PUT / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2017 03:15:40 GMT
x-oss-acl: private
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh5wQgIjWjwO/KyRt8dOP****
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>
返回示例
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Location: /oss-example
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

SDK

此接口所对应的各语言SDK如下:

错误码

错误码 HTTP 状态码 描述
InvalidBucketName 400 创建的Bucket不符合命名规范。
AccessDenied 403
  • 发起PutBucket请求时没有传入用户验证信息。
  • 没有操作权限。
TooManyBuckets 400 创建的Bucket数量超过上限。 同一用户在同一 Region内最多可创建30个Bucket。