シークレットバージョンをマークするステージラベルを更新します。

この操作を使用して、次の目的を達成できます。

  • 指定したステージラベルを使用して、新しいシークレットバージョンをマークします。
  • 既存のシークレットバージョンから特定のステージラベルを削除します。

制限: この操作は、標準シークレットでのみ使用できます。

Inこの例、ステージラベルマークバージョンsecret001秘密は更新されます。 ステージラベルACSCurrentを使用して002バージョンをマークします。

デバッグ

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

リクエストパラメーター

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

実行する操作です。 値をUpdateSecretVersionStageに設定します。
SecretName String 必須 secret001

秘密の名前。The name of the secret.
VersionStage String 必須 ACSCurrent

指定されたステージラベル。 設定可能な値は以下のとおりです。

  • ACSCurrent
  • ACSPrevious
  • カスタムステージラベル
RemoveFromVersion String 任意 001

指定したステージラベルを削除するバージョン。

注 RemoveFromVersionおよびMoveToVersionパラメーターの少なくとも1つを指定する必要があります。
MoveToVersion String 任意 002

指定したステージラベルを適用するバージョン。

注
  • RemoveFromVersionおよびMoveToVersionパラメーターの少なくとも1つを指定する必要があります。
  • VersionStageパラメーターがACSCurrentまたはACSPreviousに設定されている場合、このパラメーターは必須です。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 8cad259f-4d77-40ec-bbd7-b9c47a423bb9

リクエストの ID です。
SecretName String secret001

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

例

リクエストの例

4http(s)://[Endpoint]/? アクション=UpdateSecretVersionStage
&SecretName=secret001
&VersionStage=ACSCurrent
&MoveToVersion=002
&<共通リクエストパラメーター>

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

XML 形式 

<KMS>
<SecretName>secret001</SecretName>
<RequestId>8cad259f-4d77-40ec-bbd7-b9c47a423bb9</RequestId>
</KMS>

JSON 形式 

{
"SecretName": "secret001" 、"RequestId": "8cad259f-4d77-40ec-bbd7-b9c47a423bb9"
}

エラーコード

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