PutBucket接口用于创建存储空间（Bucket）。

说明
  • 此接口不支持匿名访问。
  • 同一阿里云账号在同一地域（Region）内最多可创建100个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-write、public-read、private

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

请求元素

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

指定Bucket存储类型。

有效值：
  • Standard（标准存储）
  • IA（低频访问）
  • Archive（归档存储）
说明 如果创建的Bucket没有指定存储类型，则默认使用Standard（标准存储）。
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内最多可创建100个Bucket。