功能说明
CreateBucket请求可以在指定账号下创建一个新的Bucket。
注意事项
存储桶一旦创建成功，名称和所处地域不能修改。
用户在每个资源池的默认配额为100个桶，用户可通过工单申请扩大配额，最大配额1000个桶。
华东1（2024年11月12日）、长沙42（2024年11月5日）、上海7（2024年11月12日）、内蒙6（2025年1月10日）、成都4（2024年11月12日）、杭州7（2024年12月3日）已于括号内的时间完成升级。在资源池升级之后新创建的桶不再有对象数量上限，您可以放心使用。在升级之前已创建的桶，对象数量上限为4亿。除上述已完成升级的地域外，其余地域暂未升级，单桶的对象数量上限仍为4亿。当桶的对象数量达到该上限后，涉及新增对象的操作有被限制的风险。
请求消息样式
PUT /{Bucket} HTTP/1.1
Host: xxx.zos.ctyun.cn
X-Amz-Content-SHA256: string
Content-Length: 0
x-amz-acl: private
x-amz-bucket-object-lock-enabled: False
x-amz-storage-class: STANDARD
X-Amz-Date: 20220401T084340Z
x-az-policy: MULTI-AZ
Authorization: authorization string请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： 桶的名称。 约束限制： 命名规则如下： - 不能与已有的任何桶名称重复。 - 创建成功后不支持修改。 - 长度范围为3到63个字符，支持小写字母、数字、中划线（-）。 - 禁止以中划线（-）开头或结尾。 | String | 是 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。但可以带附加消息头，附加请求消息头如下表所示。
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| x-amz-acl | 参数解释： 设置桶的ACL权限控制策略。 取值范围： - private：私有，桶的所有者拥有完全控制的权限，其他任何人都没有访问权限。 - public-read：公共读，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据。 - public-read-write：公共读写，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、上传对象、删除对象、初始化段任务、上传段、合并段、拷贝段、取消多段上传任务。注意：对象存储底层禁用公共读写，设置后不可匿名上传，如需使用可提工单申请。 - authenticated-read：默认情况下，上传对象至其他用户的桶中，桶拥有者没有对象的控制权限。对象拥有者为桶拥有者添加此权限控制策略后，桶所有者可以完全控制对象。 默认取值： private | String | 否 |
| x-amz-bucket-object-lock-enabled | 参数解释： 是否开启桶的Object锁定功能。 取值范围： - True - False 默认取值： False | Boolean | 否 |
| x-amz-storage-class | 参数解释： 设置桶的存储类型。 取值范围： - STANDARD：标准存储 - STANDARD_IA：低频访问存储 - GLACIER：归档存储 默认取值： STANDARD | String | 否 |
| x-az-policy | 参数解释： 设置桶的冗余策略。 约束限制： 用户携带该头域指定新创的桶的数据冗余策略，存在一种情况是当该区域如果不支持多AZ存储，则该桶的存储类型仍为单AZ。 取值范围： - SINGLE-AZ：单AZ冗余 - MULTI-AZ：多AZ冗余 默认取值： SINGLE-AZ | String | 否 |
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: string
Content-Length: 0
Date: Fri, 01 Apr 2022 08:43:40 GMT
Connection: Keep-Alive
x-amz-request-id: tx000000000000000000021-00624d98b1-1217b-default响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。
