对象存储服务 OBS-创建桶:请求消息头
下载对象存储服务 OBS用户手册完整版
请求消息头
该操作消息头与普通请求一样，请参见表3，但可以带附加消息头，附加请求消息头如下所示。
消息头名称 |
描述 |
是否必选 |
|---|---|---|
x-obs-acl |
创建桶时，可以加上此消息头设置桶的权限控制策略，使用的策略为预定义的常用策略，包括：private、public-read、public-read-write、public-read-delivered、public-read-write-delivered、bucket-owner-full-control（各策略详细说明见ACL章节的“使用头域设置ACL”）。 类型：String |
否 |
x-obs-storage-class |
创建桶时，可以加上此消息头设置桶的默认存储类型，默认存储类型有4种：STANDARD（标准存储）、WARM（低频访问存储）、COLD（归档存储）、DEEP_ARCHIVE（深度归档存储）。如果没有指定此头域，则创建的桶为标准存储类型。 类型：String |
否 |
x-obs-grant-read |
授权给指定domain下的所有用户有READ权限。允许列举桶内对象、列举桶中多段任务、列举桶中多版本对象、获取桶元数据。 类型：String 示例：x-obs-grant-read:id=租户id |
否 |
x-obs-grant-write |
授权给指定domain下的所有用户有WRITE权限。允许创建、删除、覆盖桶内所有对象，允许初始化段、上传段、拷贝段、合并段、取消多段上传任务。 类型：String 示例：x-obs-grant-write:id=租户id |
否 |
x-obs-grant-read-acp |
授权给指定domain下的所有用户有READ_ACP权限。允许读桶的ACL信息。 类型：String 示例：x-obs-grant-read-acp:id=租户id |
否 |
x-obs-grant-write-acp |
授权给指定domain下的所有用户有WRITE_ACP权限，允许修改桶的ACL信息。 类型： 字符串 示例：x-obs-grant-write-acp:id=租户id |
否 |
x-obs-grant-full-control |
授权给指定domain下的所有用户有FULL_CONTROL权限。 类型： 字符串 示例：x-obs-grant-full-control:id=租户id |
否 |
x-obs-grant-read-delivered |
授权给指定domain下的所有用户有READ权限，并且在默认情况下，该READ权限将传递给桶内所有对象。 类型：String 示例：x-obs-grant-read-delivered:id=租户id |
否 |
x-obs-grant-full-control-delivered |
授权给指定domain下的所有用户有FULL_CONTROL权限，并且在默认情况下，该FULL_CONTROL权限将传递给桶内所有对象。 类型：String 示例：x-obs-grant-full-control-delivered:id=租户id |
否 |
x-obs-az-redundancy |
创建桶时带上此消息头设置桶的存储类型为多AZ。不携带时默认为单AZ。用户携带该头域指定新创的桶的存储类型为多AZ，存在一种情况是当该区域如果不支持多AZ存储，则该桶的存储类型仍为单AZ。 类型：String 示例：x-obs-az-redundancy：3az |
否 |
x-obs-fs-file-interface |
创建桶时可以带上此消息头以创建并行文件系统。 类型：String 示例：x-obs-fs-file-interface:Enabled |
否 |
x-obs-epid |
企业项目id，开通企业项目的用户可以从企业项目服务获取，格式为uuid，默认项目传“0”或者不带该头域，未开通企业项目的用户可以不带该头域。 类型：String 示例：x-obs-epid:9892d768-2d13-450f-aac7-ed0e44c2585f |
否 |
x-obs-bucket-type |
创建桶时可以带上此消息头指定创建的桶类型，桶类型包括OBS桶和文件桶。 类型：String OBJECT：对象存储桶。 POSIX：并行文件系统。 示例：x-obs-bucket-type：OBJECT |
否 |
x-obs-bucket-object-lock-enabled |
创建桶时可以带上此消息头来开启WORM开关。 类型：String 示例：x-obs-bucket-object-lock-enabled:true |
否 |
x-obs-server-side-encryption |
创建桶时可以带上此头域来指定桶加密配置的加密模式。 类型：String 有效值：kms, obs 示例：x-obs-server-side-encryption: kms |
否 |
x-obs-server-side-data-encryption |
创建桶时带上此头域来指定服务端加密配置的加密算法。 类型：String 有效值：AES256、SM4 当携带了x-obs-server-side-encryption:kms, 该头域可选 AES256、SM4; 当携带了x-obs-server-side-encryption:obs, 该头域可选 AES256。 示例：x-obs-server-side-data-encryption: AES256 |
否 |
x-obs-server-side-encryption-kms-key-id |
SSE-KMS加密方式下使用的KMS主密钥，如果用户没有提供该头域，那么默认的主密钥将会被使用。 类型：String 有效值支持两种格式：
其中： regionID是使用密钥所属region的ID，可在地区和终端节点页面获取。
|
如果携带了x-obs-server-side-encryption: kms，该头域可选。 |
x-obs-sse-kms-key-project-id |
SSE-KMS加密方式下KMS主密钥所属的项目ID（非企业项目ID）。 类型：String 有效值：与x-obs-server-side-encryption-kms-key-id指定的KMSMasterKeyID相匹配的项目ID（非企业项目ID）。 |
如果未携带x-obs-server-side-encryption-kms-key-id，则不能携带该头域。 |
