PutBucket

注意事项

• 同一阿里云账号在同一地域（Region）内最多支持创建100个Bucket。

• 每个地域都有对应的访问域名（Endpoint）。关于地域与访问域名对应关系的更多信息，请参见访问域名和数据中心。

• 阿里云账号对同一个Bucket执行多次PutBucket请求时，第一次请求是创建Bucket，后续请求是修改Bucket的元数据（例如Bucket ACL）。多次PutBucket请求会有Bucket元数据覆盖风险，请谨慎操作。

• 北京时间2025年10月13日10:00:00起，OSS逐步调整所有地域通过API、SDK、ossutil创建Bucket时默认开启阻止公共访问。各个地域的生效变更时间，请参见公告说明。开启后，不允许创建公共访问权限，包括公共读或者公共读写ACL、以及公共访问语义的Bucket Policy。如果您的业务有公共访问需求，可在Bucket创建后关闭阻止公共访问。

请求语法

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>

• 当您在OSS ON云盒中调用该接口时，您需要将Host替换为云盒Endpoint。更多信息，请参见云盒Endpoint。

• 当您调用该接口创建无地域属性Bucket时，您需要将Host中的外网Endpoint（例如oss-cn-hangzhou.aliyuncs.com）替换为oss-rg-china-mainland.aliyuncs.com。更多信息，请参见存储空间地域属性。

请求头

此接口还需要包含公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

响应头

此接口还涉及其他公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

• 在默认资源组中创建Bucket

  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 qn6q**************:77Dv****************
  <?xml version="1.0" encoding="UTF-8"?>
  <CreateBucketConfiguration>
      <StorageClass>Standard</StorageClass>
      <DataRedundancyType>LRS</DataRedundancyType>    
  </CreateBucketConfiguration>

• 返回示例

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674E88A4D8906****
  Date: Fri, 24 Feb 2017 03:15:40 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  Location: /oss-example

• 在指定资源组中创建Bucket

  请求示例

  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
  x-oss-resource-group-id： rg-aek27tc********
  Authorization: OSS qn6q**************:77Dv****************
  <?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
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  Location: /oss-example

SDK

PutBucket接口所对应的各语言SDK如下：

• Java

• Python

• PHP

• C

• .NET

• Android

• iOS

• Node.js

• Ruby

命令行工具ossutil

PutBucket接口所对应的ossutil命令，请参见put-bucket。

错误码