更新凭据轮转策略。
接口说明
-
RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情,请参见访问控制。
-
UpdateSecretRotationPolicy 接口不支持更新通用凭据的轮转策略。
说明 因通用凭据不支持设置自动轮转,所以本接口不支持。 -
凭据开启自动轮转后,首次自动轮转的时间为上次轮转时间加上轮转周期。如果该时间早于当前时间,将会立即开始首次自动轮转。
本文将提供一个示例,更新名称为RdsSecret/Mysql5.4/MyCred
的凭据轮转策略。具体如下:
-
将
EnableAutomaticRotation
设置为true
,表示开启自动轮转。 -
将
RotationInterval
设置为30d
,表示设置轮转周期为 30 天。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
SecretName | string | 是 | 凭据名称或凭据资源名称(ARN)。 说明
访问其他阿里云账号下的凭据时,必须输入凭据 ARN。凭据 ARN 的格式为 acs:kms:${region}:${account}:secret/${secret-name} 。
| RdsSecret/Mysql5.4/MyCred |
EnableAutomaticRotation | boolean | 是 | 是否开启自动轮转,取值:
| true |
RotationInterval | string | 否 | 自动轮转的周期。取值范围:168 小时(7 天)~8,760 小时(365 天)。 格式为 说明
当 EnableAutomaticRotation 取值为 true 时,必须设置该参数。反之,将忽略该参数。
| 30d |
关于公共请求参数的详情,请参见公共参数。
返回参数
示例
正常返回示例
JSON
格式
{
"SecretName": "RdsSecret/Mysql5.4/MyCred",
"RequestId": "2c124f6f-4210-499f-b88a-69f54004d2d8"
}
错误码
访问错误中心查看更多错误码。