UpdateKMSEncryption - 更新 Secret 落盘加密功能配置 - 容器服务 Kubernetes 版 ACK

接口说明

开启或关闭落盘加密功能的过程中以及成功开启该功能后，请勿使用 KMS 控制台或 OpenAPI 禁用或删除该功能所使用的 KMS 密钥，否则会导致集群 API Server 不可用，继而无法正常获取 Secret 和 ServiceAccount 等对象，影响业务应用的正常运行。更多信息，请参见使用阿里云 KMS 进行 Secret 的落盘加密。
调用该 API 的用户或角色需要额外被授予所需的集群 RBAC 权限（需要被授予运维人员或管理员权限），否则将返回“ForbiddenUpdateKMSState”错误码。
成功调用该 API 后，集群状态将被变更为“更新中”，待变更完成后集群状态将恢复为“运行中”。针对同一个集群的变更完成后，需要间隔 5 分钟以上才能再次调用该 API，否则将返回“409”状态码。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

cs:UpdateKMSEncryption

none

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

无

PUT /clusters/{ClusterId}/kms HTTP/1.1

名称	类型	必填	描述	示例值
ClusterId	string	是	集群 ID。	c4fe1e3a721544***

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
kms_key_id	string	否	Secret 落盘加密功能使用的 KMS 密钥 ID。重要不能使用服务密钥，只能使用主密钥或者用户主密钥。该密钥的密钥类型必须是 `Aliyun_AES_256`，密钥用途必须是 `ENCRYPT/DECRYPT`。警告开启或关闭落盘加密功能的过程中以及成功开启该功能后，请勿使用 KMS 控制台或 OpenAPI 禁用或删除该 KMS 密钥，否则会导致集群 API Server 不可用，继而无法正常获取 Secret 和 ServiceAccount 等对象，影响业务应用的正常运行。	key-abc***
disable_encryption	boolean	否	是否禁用 Secret 落盘加密功能。 `true`：禁用落盘加密功能。 `false`：启用落盘加密功能。	false

名称

类型

描述

示例值

当前API暂无返回参数

正常返回示例

JSON格式

{}

访问错误中心查看更多错误码。

更多信息，参考变更详情。