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

时间:2024-10-23 16:32:26

请求参数说明

表1 请求参数列表

参数名称

参数类型

是否必选

描述

input

*SetBucketEncryptionInput

必选

参数解释:

设置桶加密配置请求参数,详见SetBucketEncryptionInput

extensions

extensionOptions

可选

参数解释:

桶相关扩展信息。通过调用拓展配置项为对应请求配置额外的拓展请求头,详情参考extensionOptions

表2 SetBucketEncryptionInput

参数名称

参数类型

是否可选

描述

Bucket

string

必选

参数解释

桶名。

约束限制:

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

默认取值

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-go-devg-obs/obs_33_0441.html