秘密を手動で回転させます。

制限事項

• 各Alibaba Cloudアカウントのシークレットは、1時間に最大50回ローテーションできます。

• RotateSecret操作は、標準シークレットでは使用できません。

この例では、RdsSecret/Mysql5.4/MyCredシークレットは手動でローテーションされ、シークレットのバージョン番号は000000123に設定されます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 RotateSecret

実行する操作です。 値をRotateSecretに設定します。
SecretName String 必須 RdsSecret/Mysql5.4/MyCred

秘密の名前。The name of the secret.
VersionId String 必須 000000123

シークレットがローテーションされた後のシークレットのバージョン番号。

注 バージョン番号は、要求のべき等性を保証するために使用される。 Secrets Managerは、このバージョン番号を使用して、アプリケーションがリクエストを再試行するときに、アプリケーションが同じバージョンのシークレットを作成しないようにします。 バージョン番号がすでに存在する場合、Secrets Managerはローテーションの要求を無視し、成功メッセージを返します。

レスポンスパラメーター

パラメーター データ型 例 説明
Arn String acs:kms:cn-hangzhou:154035569884 ****:secret/RdsSecret/Mysql5.4/MyCred

シークレットのAlibaba Cloudリソース名 (ARN) 。
SecretName String RdsSecret/Mysql5.4/MyCred

秘密の名前。The name of the secret.
VersionId String 000000123

シークレットがローテーションされた後のシークレットのバージョン番号。
RequestId String 10257c86-269d-43aa-aaf3-90ed4144bb7c

リクエストの ID です。

共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

例

リクエストの例

4http(s)://[Endpoint]/? アクション=RotateSecret
&SecretName=RdsSecret/Mysql5.4/MyCred
&VersionId=000000123
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<KMS>
<Arn>acs:kms:cn-hangzhou:154035569884 ****:secret/RdsSecret/Mysql5.4/MyCred</Arn>
<SecretName>RdsSecret/Mysql5.4/MyCred</SecretName>
<VersionId>000000123</VersionId>
<RequestId>10257c86-269d-43aa-aaf3-90ed4144bb7c</RequestId>
</KMS>

JSON 形式 

{
"Arn": "acs:kms:cn-hangzhou:154035569884 ****:secret/RdsSecret/Mysql5.4/MyCred" 、"SecretName": "RdsSecret/Mysql5.4/MyCred" 、"VersionId": "000000123" 、"RequestId": "10257c86-269d-43aa-aaf3-90ed4144bb7c"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。