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

注意事项

调用PutBucket时,有如下注意事项:

  • 此接口不支持匿名访问。
  • 同一阿里云账号在同一地域(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的访问权限ACL。

有效值:

  • public-read-write:公共读写
  • public-read:公共读
  • private:私有(默认值)

有关Bucket访问权限ACL详情,请参见设置存储空间访问权限ACL

请求元素

名称 类型 是否必选 描述
StorageClass 字符串 指定Bucket的存储类型。
有效值:
  • Standard(标准存储,默认值)
  • IA(低频访问)
  • Archive(归档存储)
DataRedundancyType 字符串

指定Bucket的数据容灾类型。

有效值:
  • LRS(默认值)

    本地冗余LRS,将您的数据冗余存储在同一个可用区的不同存储设备上,可支持两个存储设备并发损坏时,仍维持数据不丢失,可正常访问。

  • ZRS

    同城冗余ZRS采用多可用区(AZ)机制,将您的数据冗余存储在同一地域(Region)的3个可用区。可支持单个可用区(机房)整体故障时(如断电、火灾等),仍然能够保障数据的正常访问。

说明 有关数据容灾类型的更多详情,请参见存储类型介绍

示例

请求示例
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时,定义的Bucket名称不符合命名规范。
AccessDenied 403
  • 发起PutBucket请求时没有传入用户验证信息。
  • 没有操作权限。
TooManyBuckets 400 创建的Bucket数量超过上限。同一阿里云账号在同一地域(Region)内最多可创建100个Bucket。