# 创建桶-CreateBucket
#### 功能介绍
创建桶是指按照用户指定的桶名创建一个新桶的操作，新桶的桶名在OBS中必须是唯一的。了解更多创建桶的相关信息，请参见[创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html)。
#### 接口约束
- 桶创建成功后，不能修改名称和所属区域。创建时，请设置合适的桶名和区域。
- 一个账号及账号下的所有IAM用户一共可创建100个桶。建议结合OBS细粒度权限控制能力，合理进行桶规划和使用。例如，建议在桶内根据对象前缀划分不同的目录，通过[细粒度权限控制](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0023.html)实现不同目录在不同业务部门之间的权限隔离。每个桶中存放的对象的数量和大小总和没有限制，用户不需要考虑数据的可扩展性。
- 因为OBS桶是全局资源，所以您自有的桶不能重名，您与其他用户的桶也不能重名。 删桶后桶名会释放，释放完成后才能创建同名桶。调用删桶API一般耗时约30分钟释放，如遇特殊情况（例如欠费、销户触发删桶，删桶前需要先进行资源清理）耗时会更长，OBS无法保证此过程的时效性。因此创建同名桶失败，可能是由于桶名未释放完成。另外，如果桶名释放后，有其他用户在您之前抢先使用了桶名，创建同名桶也会失败。
#### 授权信息
账号根用户具备所有API的调用权限，账号的其他IAM用户需拥有创建桶的权限才能调用当前API，建议使用IAM进行授权。请在"角色与策略授权"、"身份策略授权"两种IAM授权方式中选择一种，并配置相应权限：
- 如果使用**角色与策略授权** （旧版IAM，即IAM v3接口），需具备**obs:bucket:CreateBucket** 权限，授权操作请参见[创建IAM自定义策略](https://support.huaweicloud.com/usermanual-iam/iam_01_0605.html)。
- 如果使用**身份策略授权** （新版IAM，即IAM v5接口），如下表所示，需具备**obs:bucket:createBucket** 权限，授权操作请参见[创建IAM自定义身份策略](https://support.huaweicloud.com/usermanual-iam5/iam_01_0917.html)。
| 授权项 Action | 访问级别 Access Level | 资源类型（\*为必须） Resource Type (\*: required) | [条件键](https://support.huaweicloud.com/api-obs/obs_04_0112.html#ZH-CN_TOPIC_0000002375307974__condition_table) Condition Key | [别名](https://support.huaweicloud.com/iam5_faq/iam_01_1103.html) Alias | 依赖的授权项 Dependencies |
|:---|:---|:---|:---|:---|:---|
| obs:bucket:createBucket | Write | bucket \* | - | - | - |
| obs:bucket:createBucket | Write | - | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) - obs:EpochTime - obs:SourceIp - obs:TlsVersion - obs:CustomDomain - obs:BucketEncrypted - obs:x-obs-acl | - | - |
#### URI
PUT /
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-obs/obs_04_0006.html)。调用前需要先[计算API签名](https://support.huaweicloud.com/api-obs/obs_04_0009.html)，并将签名添加到请求中。
您还可以使用[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/OBS/doc?api=CreateBucket)在线调试接口。
#### 请求消息样式
以下为请求消息样例，请将示例中的*BucketName* 修改为您的桶名，*RegionID* 修改为桶所在的区域ID，可参考[支持区域](https://console.huaweicloud.com/apiexplorer/#/endpoint/OBS)获取区域ID。
```
PUT / HTTP/1.1
Host: BucketName.obs.RegionID.myhuaweicloud.com
Content-Length: BodyLength
Date: GMT Date
Authorization: SignatureValue
x-obs-az-redundancy: 3az
RegionID
```
#### URI参数（URI Parameters）
本接口的请求消息不带URI参数。
#### 请求头参数（Request headers）
本接口请求头包括公共请求头和附加请求头，公共请求头参见[表3](https://support.huaweicloud.com/api-obs/obs_04_0007.html#ZH-CN_TOPIC_0136436606__table25197309)，附加请求头如下所示。
表1请求头参数
| **消息头名称** | **消息头类型** | **是否必选** | **描述** |
|:---|:---|:---|:---|
| x-obs-acl | String | 否 | **参数解释：** 创建桶时，可以加上此消息头设置桶的权限控制策略，使用的策略为预定义的ACL策略。 **约束限制：** OBS支持使用服务控制策略 (Service Control Policies，以下简称SCP)管理组织成员账号的行为，如果您所在的组织或组织单元使用SCP限制x-obs-acl的取值范围，例如SCP规定在创建桶或并行文件系统时不允许将x-obs-acl赋值为public-read、public-read-write，则携带禁止值的创建请求会失败，并返回403。了解更多SCP相关信息请参见[SCP简介](https://support.huaweicloud.com/usermanual-organizations/org_03_0032.html)。 **取值范围：** - private：桶或对象的所有者拥有完全控制的权限，其他任何人都没有访问权限。 - public-read：设置在桶上时，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据。 - public-read-write：设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、上传对象、删除对象、初始化段任务、上传段、合并段、拷贝段、取消多段上传任务。 - public-read-delivered：设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据，可以获取该桶内对象的内容和元数据。 - public-read-write-delivered：设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、上传对象、删除对象、初始化段任务、上传段、合并段、拷贝段、取消多段上传任务，可以获取该桶内对象的内容和元数据。 - bucket-owner-full-control：设在对象上，桶和对象的所有者拥有对象的完全控制权限，其他任何人都没有访问权限。 默认情况下，上传对象至其他用户的桶中，桶拥有者没有对象的控制权限。对象拥有者为桶拥有者添加此权限控制策略后，桶所有者可以完全控制对象。 例如，用户A上传对象x至用户B的桶中，系统默认用户B没有对象x的控制权。当用户A为对象x设置bucket-owner-full-control策略后，用户B就拥有了对象x的控制权。 **默认取值：** private |
| x-obs-storage-class | String | 否 | **参数解释：** 创建桶时，可以加上此消息头设置桶的默认存储类型。 **取值范围：** - STANDARD：标准存储，具有低访问时延和较高的吞吐量，因而适用于有大量热点文件需要频繁访问数据的业务场景，例如：大数据、移动应用、热点视频、社交图片等场景 - WARM：低频访问存储，适用于不频繁访问（少于每月一次访问）但在需要时也要求快速访问数据的业务场景，例如：文件同步/共享、企业备份等场景。 - COLD：归档存储，适用于很少访问（平均一年访问一次）数据的业务场景，例如：数据归档、长期备份等场景。归档存储安全、持久且成本极低，可以用来替代磁带库。 - DEEP_ARCHIVE：深度归档存储，适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。 注意： 深度归档数据存储不会跨境传输。 **默认取值：** STANDARD |
| x-obs-grant-read | String | 否 | **参数解释：** 授权READ权限给指定domain下的所有用户。允许列举桶内对象、列举桶中多段任务、列举桶中多版本对象、获取桶元数据。 示例：x-obs-grant-read:id=租户id **约束限制：** 无 **取值范围：** id=租户id，获取方式请参考[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 **默认取值：** 无 |
| x-obs-grant-write | String | 否 | **参数解释：** 授权WRITE权限给指定domain下的所有用户，允许创建、删除、覆盖桶内所有对象，允许初始化段、上传段、拷贝段、合并段、取消多段上传任务。 示例：x-obs-grant-write:id=租户id **约束限制：** 无 **取值范围：** id=租户id，获取方式请参考[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 **默认取值：** 无 |
| x-obs-grant-read-acp | String | 否 | **参数解释：** 授权READ_ACP权限给指定domain下的所有用户，允许读桶的ACL信息。 示例：x-obs-grant-read-acp:id=租户id **约束限制：** 无 **取值范围：** id=租户id，获取方式请参考[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 **默认取值：** 无 |
| x-obs-grant-write-acp | String | 否 | **参数解释：** 授权WRITE_ACP权限给指定domain下的所有用户，允许修改桶的ACL信息。 示例：x-obs-grant-write-acp:id=租户id **约束限制：** 无 **取值范围：** id=租户id，获取方式请参考[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 **默认取值：** 无 |
| x-obs-grant-full-control | String | 否 | **参数解释：** 授权FULL_CONTROL权限给指定domain下的所有用户。 示例：x-obs-grant-full-control:id=租户id **约束限制：** 无 **取值范围：** id=租户id，获取方式请参考[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 **默认取值：** 无 |
| x-obs-grant-read-delivered | String | 否 | **参数解释：** 授权READ权限给指定domain下的所有用户，并且在默认情况下，该READ权限将传递给桶内所有对象。 示例：x-obs-grant-read-delivered:id=租户id **约束限制：** 无 **取值范围：** id=租户id，获取方式请参考[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 **默认取值：** 无 |
| x-obs-grant-full-control-delivered | String | 否 | **参数解释：** 授权FULL_CONTROL权限给指定domain下的所有用户，并且在默认情况下，该FULL_CONTROL权限将传递给桶内所有对象。 示例：x-obs-grant-full-control-delivered:id=租户id **约束限制：** 无 **取值范围：** id=租户id，获取方式请参考[获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.html)。 **默认取值：** 无 |
| x-obs-az-redundancy | String | 否 | **参数解释：** 创建桶时带上此消息头设置桶的数据冗余策略。 **约束限制：** 用户携带该头域指定新创的桶的数据冗余策略，存在一种情况是当该区域如果不支持多AZ存储，则该桶的存储类型仍为单AZ。 **取值范围：** - 3az：多AZ，可靠性更高。 **默认取值：** 不指定头域，默认为单AZ。 |
| x-obs-fs-file-interface | String | 否 | **参数解释：** 创建桶时可以带上此消息头以创建并行文件系统。 示例：x-obs-fs-file-interface:Enabled **取值范围：** Enabled **默认取值：** 指定头域时必须为Enabled，无默认取值。 |
| x-obs-epid | String | 否 | **参数解释：** 企业项目ID。开通企业项目的用户可以从企业项目服务获取，格式为uuid，默认项目传"0"或者不带该头域，未开通企业项目的用户可以不带该头域。 示例：x-obs-epid:9892d768-2d13-450f-aac7-ed0e44c2585f **约束限制：** 无 **取值范围：** 填写正确的企业项目ID或者为ID为0。 **默认取值：** 0 |
| x-obs-bucket-type | String | 否 | **参数解释：** 创建桶时可以带上此消息头指定创建的桶类型，桶类型包括OBS桶和文件桶。 示例：x-obs-bucket-type：OBJECT **约束限制：** 无 **取值范围：** - OBJECT：对象存储桶。 - POSIX：并行文件系统。 **默认取值：** 指定头域时必须手动指定取值，无默认取值。不指定头域时，默认为OBJECT。 |
| x-obs-bucket-object-lock-enabled | String | 否 | **参数解释：** 创建桶时可以带上此消息头来开启WORM开关。 示例：x-obs-bucket-object-lock-enabled:true **约束限制：** - 只支持对象桶，不支持并行文件系统。 - 在打开WORM开关的时候会默认为桶开启多版本，且多版本状态无法关闭 **取值范围：** - true：开启WORM开关 **默认取值：** 指定头域为true或True时，开启桶的对象锁策略；如果不指定头域时，不开启对象锁策略。 |
| x-obs-server-side-encryption | String | 否 | **参数解释：** 创建桶时可以带上此头域来指定桶加密配置的加密模式。示例：x-obs-server-side-encryption: kms **约束限制：** 无 **取值范围：** - kms：使用SSE-KMS加密方式 - obs：使用SSE-OBS加密方式 **默认取值：** 指定头域时必须指定对应的值，无默认值。不指定头域时不开启桶加密。 |
| x-obs-server-side-data-encryption | String | 否 | **参数解释：** 创建桶时带上此头域来指定服务端加密配置的加密算法。 示例：x-obs-server-side-data-encryption: AES256 **约束限制:** 无 **取值范围：** - AES256：使用AES256加密算法，SSE-KMS和SSE-OBS都可以配置AES256。 - SM4：使用SM4加密算法，仅SSE-KMS可以配置SM4。 **默认取值：** 无 |
| x-obs-server-side-encryption-kms-key-id | String | 如果携带了x-obs-server-side-encryption: kms，该头域可选。 | **参数描述：** 当加密方式为SSE-KMS且使用指定密钥加密时，需输入密钥ID。密钥ID获取方法请参见[查看密钥](https://support.huaweicloud.com/usermanual-dew/dew_01_0179.html)。 类型：String **约束限制：** 当您设置了x-obs-server-side-encryption头域且赋值为"kms"，即选择kms加密方式时，才能使用该头域指定加密密钥。 **默认取值：** 当您选择使用kms加密方式，但未设置此头域时，默认的主密钥将会被使用。如果默认主密钥不存在，系统将默认创建并使用。 |
| x-obs-server-side-encryption-bucket-key-enabled | String | 否 | **参数解释：** SSE-KMS桶密钥功能开关。 **约束限制：** 当您设置本头域为"true"时，必须同时设置本接口的另一个头域x-obs-server-side-encryption-kms-key-id以指定密钥ID。 **取值范围：** - true：开启桶密钥。 - false：关闭桶密钥。 **默认取值：** false |
| x-obs-sse-kms-key-project-id | String | 如果未携带x-obs-server-side-encryption-kms-key-id，则不能携带该头域。 | **参数解释：** SSE-KMS加密方式下KMS主密钥所属的项目ID（非企业项目ID）。 **约束限制：** 无 **取值范围：** 与x-obs-server-side-encryption-kms-key-id指定的密钥ID相匹配的项目ID（非企业项目ID）。 **默认取值：** 无 |
| x-obs-ies-location | String | 否 | **参数解释：** 如果是要在CloudPond站点上创建桶，需要携带此头域，头域值为CloudPond站点的AZ ID。此参数和x-obs-cluster-type不可共存。 **约束限制：** 携带的CloudPond站点AZ id必有效。 **取值范围：** 无 **默认取值：** 无 |
| x-obs-edge-location | String | 否 | **参数解释：** 如果是要在智能边缘云站点上创建桶，需要携带此头域，头域值为智能边缘云站点的AZ ID。此参数和x-obs-cluster-type不可共存。 **约束限制：** 携带的智能边缘云站点AZ id必有效。 **取值范围：** 无 **默认取值：** 无 |
#### 请求体参数（Request body）
表2请求体参数
| **元素名称** | **元素类型** | **是否必选** | **描述** |
|:---|:---|:---|:---|
| Location | String | 否 | **参数解释：** 指定Bucket在哪个区域被创建。 - 使用华北-北京一的终端节点创建桶时 - 不携带Location，桶将默认创建在华北-北京一（cn-north-1） - 在Location中指定其它区域，例如华北-北京四（cn-north-4），桶将创建在指定区域 - 使用华北-北京一以外其它区域的终端节点创建桶时，必须携带Location，并且Location只能指定为该终端节点对应的区域。 例如使用obs.cn-north-4.myhuaweicloud.com终端节点创建桶时，必须指定Location为cn-north-4。 **约束限制：** 该参数定义了桶将会被创建在哪个区域，如果使用的终端节点是obs.myhuaweicloud.com，可以不携带此参数；如果使用的终端节点不是obs.myhuaweicloud.com，则必须携带此参数。 **取值范围：** 有关OBS区域和终端节点的更多信息，请参考[地区和终端节点](https://developer.huaweicloud.com/endpoint?OBS)。 **默认取值：** 终端节点为obs.myhuaweicloud.com且用户未设定区域时，默认为华北-北京一（cn-north-1）。 |
#### 响应消息样式
```
HTTP/1.1 status_code
Location: /BucketName
Date: GMT Date
Content-Length: BodyLength
```
#### 响应头 (Response Headers)
该请求的响应消息使用公共响应头，具体请参考[表1](https://support.huaweicloud.com/api-obs/obs_04_0013.html#ZH-CN_TOPIC_0173612084__d0e686)。
除公共响应头之外，本接口还可以返回附加响应头，如下表所示。
表3附加响应头
| **消息头名称** | **消息头类型** | **描述** |
|:---|:---|:---|
| Location | String | **参数解释：** 桶地址，由"/"+"桶名"组成。例如：/exampleBucket **取值范围：** 桶名 |
| x-obs-server-side-encryption | String | **参数解释：** 桶的加密模式。示例：x-obs-server-side-encryption: kms **取值范围：** - kms：使用SSE-KMS加密方式 - obs：使用SSE-OBS加密方式 |
| x-obs-server-side-data-encryption | String | **参数解释：** 服务端加密配置的加密算法。示例：x-obs-server-side-data-encryption: AES256 **取值范围：** - AES256：使用AES256算法，SSE-KMS和SSE-OBS都可以配置AES256 - SM4：使用SM4算法，仅SSE-KMS方式可配置SM4 |
| x-obs-server-side-encryption-kms-key-id | String | **参数描述：** 加密方式为SSE-KMS且使用自定义KMS主密钥加密时，返回KMS主密钥的密钥ID。 **取值范围：** 不涉及 |
| x-obs-sse-kms-key-project-id | String | **参数解释：** 加密方式为SSE-KMS且使用自定义KMS密钥加密时，返回KMS主密钥所属的项目ID（非企业项目ID）。 **取值范围：** x-obs-server-side-encryption-kms-key-id指定的KMS主密钥所属的项目ID（非企业项目ID）。 |
#### 响应体 (Response Body)
本接口的响应消息中不携带响应体。
#### 错误响应消息
无特殊错误，所有错误已经包含在[错误码概述](https://support.huaweicloud.com/api-obs/obs_04_0115.html)中。
#### 请求示例：创建桶
```
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Wed, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157
cn-north-4
```
#### 响应示例：创建桶
```
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: Wed, 01 Jul 2015 02:25:06 GMT
Content-Length: 0
```
#### 请求示例：创建指定ACL和存储类型的桶
```
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Wed, 01 Jul 2015 02:25:05 GMT
x-obs-acl:public-read
x-obs-storage-class:STANDARD
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157
cn-north-4
```
#### 响应示例：创建指定ACL和存储类型的桶
```
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: Wed, 01 Jul 2015 02:25:06 GMT
Content-Length: 0
```
#### 请求示例：创建桶时选择AZ
```
PUT / HTTP/1.1
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Content-Length: length
Date: date
Authorization: authorization
x-obs-az-redundancy: 3az
cn-north-4
```
#### 响应示例：创建桶时选择AZ
```
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: Wed, 01 Jul 2015 02:25:06 GMT
Content-Length: 0
```
#### 请求示例：创建并行文件系统
```
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Wed, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157
x-obs-fs-file-interface: Enabled
cn-north-4
```
#### 响应示例：创建并行文件系统
```
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: Wed, 01 Jul 2015 02:25:06 GMT
Content-Length: 0
```
#### 请求示例：创建桶时打开WORM开关
```
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Wed, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
x-obs-bucket-object-lock-enabled:true
Content-Length: 0
```
#### 响应示例：创建桶时打开WORM开关
```
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 00000184C11AC7A6809F881341842C02
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: Wed, 01 Jul 2015 02:25:06 GMT
Content-Length: 0
```
#### 请求示例：创建桶时设置SSE-KMS模式服务端加密配置
```
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Wed, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
x-obs-server-side-encryption: kms
x-obs-server-side-data-encryption: AES256
Content-Length: 0
```
#### 响应示例：创建桶时设置SSE-KMS模式服务端加密配置
```
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 0000018865CDACCA53062E5C2674A8FC
Location: /examplebucket
x-obs-server-side-encryption: kms
x-obs-server-side-data-encryption: AES256
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: Wed, 01 Jul 2015 02:25:06 GMT
Content-Length: 0
```
#### 请求示例：创建桶时使用指定的KMS密钥设置服务端加密配置
```
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Wed, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
x-obs-server-side-encryption: kms
x-obs-server-side-data-encryption: AES256
x-obs-server-side-encryption-kms-key-id: 8r3u893k-fops-32m9-ba8e-9e4989b130ba
x-obs-sse-kms-key-project-id: z2a619fc6s9e4062aca895fa612qd095
Content-Length: 0
```
#### 响应示例：创建桶时使用指定的KMS密钥设置服务端加密配置
```
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 0000018865CDACCA53062E5C2674A8FC
Location: /examplebucket
x-obs-server-side-encryption: kms
x-obs-server-side-data-encryption: AES256
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: Wed, 01 Jul 2015 02:25:06 GMT
Content-Length: 0
```
#### 请求示例：创建桶并显式配置访问权限
```
PUT / HTTP/1.1
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:iqSPeUBl66PwXDApxjRKk6hlcN4=
x-obs-grant-read: id=783fc6vz2cf2442c096evxxxxxxxxxxxx
x-obs-grant-write: id=3u3fc6vz2cf24mc830fhsxxxxxxxxxxxx
x-obs-grant-read-acp: id=902su2vz2cf2vire.239caxxxxxxxxxxxx
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Date: Wed, 01 Jul 2015 02:37:22 GMT
Content-Type: application/xml
region
```
#### 响应示例：创建桶并显式配置访问权限
```
HTTP/1.1 200 OK
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCTeau73DlKTh4wPYzoZf5w3KacolerP4
x-obs-request-id: 0000018A2A22B72447CF01A99F32E2B0
Server: OBS
Content-Length: 0
Date: Wed, 01 Jul 2015 02:37:22 GMT
Location: /examplebucket
```
#### 使用SDK调用接口
建议您使用OBS SDK调用接口。SDK对API进行了封装以简化您的开发工作，直接调用SDK接口函数即可访问OBS，无需手动计算签名。
| [Java](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0401.html) | [Python](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0801.html) | [C](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0301.html) | [Go](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0402.html) | BrowserJS不支持创建桶 | [.NET](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0301.html) | [Android](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0301.html) | [iOS](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0301.html) | [PHP](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0301.html) | [Node.js](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0301.html) |
|---|---|---|---|---|---|---|---|---|---|
#### 相关文档
- 使用obsutil创建桶，请参见[创建桶](https://support.huaweicloud.com/utiltg-obs/obs_11_0008.html)。
- 使用OBS Browser+创建桶，请参见[创建桶](https://support.huaweicloud.com/browsertg-obs/obs_03_1041.html)。
- 了解更多创建桶的相关信息，请参见[创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html)。
- API操作涉及的计费项参见[计费项](https://support.huaweicloud.com/price-obs/obs_42_0002.html)。