创建桶

x-obs-acl

String

否

参数解释：

创建桶时，可以加上此消息头设置桶的权限控制策略，使用的策略为预定义的ACL策略。

取值范围：

• 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。

默认取值：

无

x-obs-grant-write

String

否

参数解释：

授权WRITE权限给指定domain下的所有用户，允许创建、删除、覆盖桶内所有对象，允许初始化段、上传段、拷贝段、合并段、取消多段上传任务。

示例：x-obs-grant-write:id=租户id

约束限制：

无

取值范围：

id=租户id，获取方式请参考获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

默认取值：

无

x-obs-grant-read-acp

String

否

参数解释：

授权READ_ACP权限给指定domain下的所有用户，允许读桶的ACL信息。

示例：x-obs-grant-read-acp:id=租户id

约束限制：

无

取值范围：

id=租户id，获取方式请参考获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

默认取值：

无

x-obs-grant-write-acp

字符串

否

参数解释：

授权WRITE_ACP权限给指定domain下的所有用户，允许修改桶的ACL信息。

示例：x-obs-grant-write-acp:id=租户id

约束限制：

无

取值范围：

id=租户id，获取方式请参考获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

默认取值：

无

x-obs-grant-full-control

字符串

否

参数解释：

授权FULL_CONTROL权限给指定domain下的所有用户。

示例：x-obs-grant-full-control:id=租户id

约束限制：

无

取值范围：

id=租户id，获取方式请参考获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

默认取值：

无

x-obs-grant-read-delivered

String

否

参数解释：

授权READ权限给指定domain下的所有用户，并且在默认情况下，该READ权限将传递给桶内所有对象。

示例：x-obs-grant-read-delivered:id=租户id

约束限制：

无

取值范围：

id=租户id，获取方式请参考获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

默认取值：

无

x-obs-grant-full-control-delivered

String

否

参数解释：

授权FULL_CONTROL权限给指定domain下的所有用户，并且在默认情况下，该FULL_CONTROL权限将传递给桶内所有对象。

示例：x-obs-grant-full-control-delivered:id=租户id

约束限制：

无

取值范围：

id=租户id，获取方式请参考获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

默认取值：

无

x-obs-az-redundancy

String

否

参数解释：

创建桶时带上此消息头设置桶的存储类型为多AZ，不携带时默认为单AZ。示例：x-obs-az-redundancy：3az

约束限制：

用户携带该头域指定新创的桶的存储类型为多AZ，存在一种情况是当该区域如果不支持多AZ存储，则该桶的存储类型仍为单AZ。

取值范围：

3az

默认取值：

指定头域时必须为3az，无默认取值。不指定头域，默认为单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

约束限制：

只支持对象桶。

取值范围：

true：开启WORM开关

默认取值：

指定头域时必须为true，无默认取值。不指定头域时，不开启WORM。

x-obs-server-side-encryption

String

否

参数解释：

创建桶时可以带上此头域来指定桶加密配置的加密模式。

示例：x-obs-server-side-encryption: kms

约束限制：

无

取值范围：

• kms
• obs

默认取值：

指定头域时必须指定对应的值，无默认值。不指定头域时不开启桶加密。

x-obs-server-side-data-encryption

String

否

参数解释：

创建桶时带上此头域来指定服务端加密配置的加密算法。

示例：x-obs-server-side-data-encryption: AES256

约束限制:

无

取值范围：

• AES256
• SM4

当携带了x-obs-server-side-encryption:kms，该头域可选 AES256、SM4；

当携带了x-obs-server-side-encryption:obs，该头域可选 AES256。

默认取值：

无

x-obs-server-side-encryption-kms-key-id

String

如果携带了x-obs-server-side-encryption: kms，该头域可选。

参数描述：

当加密方式为SSE-KMS且使用指定密钥加密时，需输入密钥ID。密钥ID获取方法请参见查看密钥。

类型：String

约束限制：

当您设置了x-obs-server-side-encryption头域且赋值为“kms”，即选择kms加密方式时，才能使用该头域指定加密密钥。

默认取值：

当您选择使用kms加密方式，但未设置此头域时，默认的主密钥将会被使用。如果默认主密钥不存在，系统将默认创建并使用。

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指定的KMSMasterKeyID相匹配的项目ID（非企业项目ID）。

默认取值：

无

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区域和终端节点的更多信息，请参考地区和终端节点。

默认取值：

终端节点为obs.myhuaweicloud.com且用户未设定区域时，默认为华北-北京一（cn-north-1）。