You need to enable JavaScript to run this app.
Key Management System

Key Management System

Copy page
Download PDF
Secret manager
UpdateSecretRotationPolicy - Update secret rotation policy
Copy page
Download PDF
UpdateSecretRotationPolicy - Update secret rotation policy

Update secret rotation policy

Debug

Request parameters

The table below lists only the parameters unique to this interface and some common parameters. For more information, see common parameters.

Parameter
Type
Required
Example value
Description
Action
String

UpdateSecretRotationPolicy

Version
String
yes

2021-02-18

API version, value: 2021-02-18.

SecretName
String
yes

secret-9527

secret name, length 2 to 128 characters. Valid characters: [a-zA-Z0-9/_+=.@-]

AutomaticRotation
Boolean
yes

true

Whether to enable automatic rotation, applicable only to IAM|RDS|Redis|ECS type secrets.

RotationInterval
String
No

7d

Automatic rotation cycle, valid range: 1 ~ 365 days.
Format is integer[unit], where integer indicates the length of time, and unit indicates the time unit. Unit values: d (days).
For example: 7d means a cycle of 7 days.

response parameters

This interface has no unique return parameters. For more information, see response structure.

Request example

GET /?Action=UpdateSecretRotationPolicy&Version=2021-02-18&SecretName=secret-9527&AutomaticRotation=true&RotationInterval=7d HTTP/1.1 
Host: kms.cn-beijing.volcengineapi.com 
X-Date: 20240810T101600Z 
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240810/cn-beijing/kms/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f


Response example

{ 
  "ResponseMetadata": { 
    "RequestId": "2024081018161620010206223496683E", 
    "Action": "UpdateSecretRotationPolicy", 
    "Version": "2021-02-18", 
    "Service": "kms", 
    "Region": "cn-beijing" 
  }, 
  "Result": {} 
}

Error code

The following table lists error codes related to this interface and business logic. Refer to the Public Error Codes document for public error codes.

Status Code
Error Code
Error Message
Description
400
InvalidParameter

The request parameter %s is invalid.

400
InvalidSecretType

The secret type [%s] does not allow to perform this action.

400
InvalidSecretStatus

The secret status [%s] does not allow to perform this action.

403
AccessDenied

User is not authorized to do this action

403
Reject.Throttling.Action

The request of Action: %s upper limit is exceeded.

404
Not Found

Not found %s [%s].

500
UndefinedError

Undefined Internal Error. Pls Contact With Admin.

Last updated: 2025.06.27 15:24:19