UpdateSecretRotationPolicy - 更新动态凭据的轮转策略

更新凭据轮转策略。

接口说明

  • RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情,请参见访问控制

  • UpdateSecretRotationPolicy 接口不支持更新通用凭据的轮转策略。

    说明 因通用凭据不支持设置自动轮转,所以本接口不支持。
  • 凭据开启自动轮转后,首次自动轮转的时间为上次轮转时间加上轮转周期。如果该时间早于当前时间,将会立即开始首次自动轮转。

本文将提供一个示例,更新名称为RdsSecret/Mysql5.4/MyCred的凭据轮转策略。具体如下:

  • EnableAutomaticRotation设置为true,表示开启自动轮转。

  • RotationInterval设置为30d,表示设置轮转周期为 30 天。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
SecretNamestring

凭据名称或凭据资源名称(ARN)。

说明 访问其他阿里云账号下的凭据时,必须输入凭据 ARN。凭据 ARN 的格式为acs:kms:${region}:${account}:secret/${secret-name}
RdsSecret/Mysql5.4/MyCred
EnableAutomaticRotationboolean

是否开启自动轮转,取值:

  • true:开启自动轮转。
  • false(默认值):不开启自动轮转。
true
RotationIntervalstring

自动轮转的周期。取值范围:168 小时(7 天)~8,760 小时(365 天)。

格式为integer\[unit\],其中integer表示时间长度,unit表示时间单位。
unit 取值:d(天)、h(小时)、m(分钟)、s(秒)。例如:7d 或者 604,800s 均表示 7 天的周期。

说明 当 EnableAutomaticRotation 取值为 true 时,必须设置该参数。反之,将忽略该参数。
30d

关于公共请求参数的详情,请参见公共参数

返回参数

名称类型描述示例值
object
SecretNamestring

凭据名称。

RdsSecret/Mysql5.4/MyCred
RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

2c124f6f-4210-499f-b88a-69f54004d2d8

示例

正常返回示例

JSON格式

{
  "SecretName": "RdsSecret/Mysql5.4/MyCred",
  "RequestId": "2c124f6f-4210-499f-b88a-69f54004d2d8"
}

错误码

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