创建桶

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简介。

取值范围：

• 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

String

否

参数解释：

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

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

约束限制：

无

取值范围：

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

默认取值：

无

x-obs-grant-full-control

String

否

参数解释：

授权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。

取值范围：

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

默认取值：

无

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

默认取值：

无

Location

String

否

参数解释：

指定Bucket在哪个区域被创建。

• 使用华北-北京一的终端节点创建桶时
  • 不携带Location，桶将默认创建在华北-北京一（cn-north-1）
  • 在Location中指定其它区域，例如中国-香港（ap-southeast-1），桶将创建在指定区域
• 使用华北-北京一以外其它区域的终端节点创建桶时，必须携带Location，并且Location只能指定为该终端节点对应的区域。

  例如使用obs.ap-southeast-1.myhuaweicloud.com终端节点创建桶时，必须指定Location为ap-southeast-1。

取值范围：

有关OBS区域和终端节点的更多信息，请参考地区和终端节点。

默认取值：

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

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

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

Java

Python

C

Go

BrowserJS不支持创建桶

.NET

Android

iOS

PHP

Node.js