对象存储服务 OBS-设置桶的加密配置(Harmony SDK):请求参数

时间:2025-02-26 17:01:48

请求参数

表1 请求参数列表

参数名称

参数类型

是否必选

描述

input

SetBucketEncryptionInput

必选

参数解释:

设置桶加密配置接口入参,详见SetBucketEncryptionInput

表2 SetBucketEncryptionInput

参数名称

参数类型

是否可选

描述

Bucket

string

必选

桶名。

约束限制:

  • 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。
  • 桶命名规则如下:
    • 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。
    • 禁止使用IP地址。
    • 禁止以“-”或“.”开头及结尾。
    • 禁止两个“.”相邻(如:“my..bucket”)。
    • 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。
  • 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。

取值范围:

长度为3~63个字符。

Rule

BucketEncryptionRule

必选

参数解释:

桶加密配置信息,详见BucketEncryptionRule

表3 BucketEncryptionRule

参数名称

参数类型

是否可选

描述

ApplyServerSideEncryptionByDefault

ApplyServerSideEncryptionByDefault

必选

参数解释:

默认加密配置信息,详见ApplyServerSideEncryptionByDefault

表4 ApplyServerSideEncryptionByDefault

参数名称

参数类型

是否可选

描述

SSEAlgorithm

string

必选

参数解释:

表示服务端加密是SSE-KMS方式。对象使用SSE-KMS方式加密。

取值范围:

可选值:kms,即选择SSE-KMS方式加密对象。

默认取值:

KMSMasterKeyID

string

可选

参数解释:

SSE-KMS加密方式下使用的KMS主密钥

取值范围:

有效值支持两种格式:

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

其中:

默认取值:

如果用户没有提供该头域,那么默认的主密钥将会被使用

ProjectID

string

可选

参数解释:

SSE-KMS加密方式下KMS主密钥所属的项目ID。

约束限制:

  • 项目ID需要与KMSMasterKeyID相匹配
  • 在未设置KMSMasterKeyID的情况下,不可设置项目ID。

取值范围:

项目ID获取方式请参见如何获取项目ID

默认取值:

support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0639.html