更新时间:2025-12-10 GMT+08:00

轮转密钥

功能介绍

轮转加密集群密钥。

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/clusters/{cluster_id}/rotate-key

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

集群ID。获取方法请参见获取集群ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

master_key_id

String

参数解释

KMS密钥ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

master_key_name

String

参数解释

KMS密钥名称

取值范围

不涉及。

cluster_id

String

参数解释

集群ID。

取值范围

不涉及。

rotate_key_time

String

参数解释

轮转时间。

取值范围

不涉及。

请求示例

轮转集群KMS密钥ID为“0f3196c8-5c23-469f-84da-92ecd2499dce”。

POST https://{Endpoint}/v1/05f2cff45100d5112f4bc00b794ea08e/clusters/9f76c502-fc9c-4a52-8656-65d0da6e3d57/rotate-key

{
  "master_key_id" : "0f3196c8-5c23-469f-84da-92ecd2499dce"
}

响应示例

状态码:200

轮转密钥请求成功。

{
  "master_key_name" : "KMS-1abd-1016",
  "cluster_id" : "9f76c502-fc9c-4a52-8656-65d0da6e3d57",
  "rotate_key_time" : "2025-05-14 08:02:59"
}

状态码

状态码

描述

200

轮转密钥请求成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

500

服务内部错误。

503

服务不可用。