对象存储服务 OBS-设置桶的加密配置:请求消息元素

时间:2024-10-21 15:06:42

请求消息元素

在此请求中,需要在请求的消息体中配置桶的加密配置。桶加密的配置信息以XML格式上传。具体的配置元素如表1

表1 桶的加密配置元素

消息头名称

描述

是否必选

ServerSideEncryptionConfiguration

桶的默认加密配置的根元素。

类型:Container

父元素:无

子元素:Rule

Rule

桶的默认加密配置的子元素。

类型:Container

父元素:ServerSideEncryptionConfiguration

子元素:ApplyServerSideEncryptionByDefault

ApplyServerSideEncryptionByDefault

桶的默认加密配置的子元素。

类型:Container

父元素:Rule

子元素:SSEAlgorithm,KMSMasterKeyID

SSEAlgorithm

桶的默认加密配置要使用的服务端加密算法。

类型:String

有效值:

  • kms:使用SSE-KMS加密方式,默认使用AES256算法;如果您需要使用SM4加密算法,还需要配置KMSDataEncryption。
  • AES256:使用SSE-OBS加密方式,且使用AES256加密算法。

父元素:ApplyServerSideEncryptionByDefault

KMSDataEncryption

SSE-KMS加密方式下的 数据加密 算法。

类型:String

有效值:SM4

父元素:ApplyServerSideEncryptionByDefault

KMSMasterKeyID

SSE-KMS加密方式下使用的KMS主密钥,如果用户没有提供该头域,那么默认的主密钥将会被使用。

类型:String

有效值支持两种格式:

  1. regionID:domainID(账号ID):key/key_id
  2. key_id

其中:

  • regionID是使用密钥所属region的ID,可在地区和终端节点页面获取;
  • domainID是使用密钥所属账号的账号ID,获取方法参见获取账号、 IAM 用户、项目、用户组、区域、委托的名称和ID;
  • key_id是从数据加密服务创建的密钥ID,获取方法请参见查看密钥

父元素:ApplyServerSideEncryptionByDefault

ProjectID

SSE-KMS加密方式下KMS主密钥所属的项目ID。如果KMS主密钥所属的项目为非默认项目,则需要通过该参数进行项目ID指定。

类型:String

有效值:

  1. 与KMSMasterKeyID相匹配的项目ID。
  2. 在未设置KMSMasterKeyID的情况下,不可设置项目ID。

父元素:ApplyServerSideEncryptionByDefault

说明:

使用非默认IAM项目下的自定义密钥对桶内对象进行SSE-KMS加密,只有密钥拥有者可以对加密后的对象进行上传下载类操作,非密钥拥有者不能对加密后的对象进行上传下载类操作。

support.huaweicloud.com/api-obs/obs_04_0062.html