UpdateSecretVersionStage - - Alibaba Cloud ドキュメントセンター

操作説明

Resource Access Management (RAM) ユーザーまたは RAM ロールとしてこの操作を呼び出すために必要なアクセスポリシーについては、「Resource Access Management」をご参照ください。
この操作は汎用シークレットのみをサポートしています。以下の操作を実行できます。
- 指定されたシークレットバージョンにバージョンステージを追加します。
- 指定されたシークレットバージョンからバージョンステージを削除します。
- 指定されたシークレットバージョンからバージョンステージを削除し、別のシークレットバージョンにアタッチします。
各汎用シークレットのバージョンステージの総数は 8 を超えることはできません。

このトピックでは、secret001 という名前のシークレットのバージョンステージを更新する例を示します。この例では、ACSCurrent ステージを使用してバージョン 002 をマークします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	タイプ	必須 / 任意	説明	例
SecretName	string	必須	シークレットの名前または Alibaba Cloud リソースネーム (ARN)。説明別の Alibaba Cloud アカウントのシークレットにアクセスするには、シークレットの ARN を指定する必要があります。ARN の形式は `acs:kms:${region}:${account}:secret/${secret-name}` です。	secret001
VersionStage	string	必須	シークレットのバージョンステージ。シナリオ 1：指定されたシークレットバージョンにバージョンステージを追加する。このパラメーターと MoveToVersion を指定します。RemoveFromVersion は指定しないでください。このパラメーターは、ACSCurrent、ACSPrevious、またはカスタムステージに設定できます。シナリオ 2：指定されたシークレットバージョンからバージョンステージを削除する。このパラメーターと RemoveFromVersion を指定します。MoveToVersion は指定しないでください。このパラメーターはカスタムステージに設定する必要があります。説明 ACSCurrent と ACSPrevious はシステム予約ステージです。直接削除することはできません。1 つのシークレットバージョンから削除して別のバージョンにアタッチすることのみ可能です。シナリオ 3：指定されたシークレットバージョンからバージョンステージを削除し、別のシークレットバージョンにアタッチする。このパラメーター、MoveToVersion、および RemoveFromVersion を指定します。このパラメーターは、ACSCurrent、ACSPrevious、またはカスタムステージに設定できます。	ACSCurrent
RemoveFromVersion	string	任意	シークレットのバージョン番号。このパラメーターは、VersionStage で設定されたバージョンステージがこのバージョンから削除されることを指定します。説明 RemoveFromVersion と MoveToVersion の少なくとも 1 つを指定する必要があります。	001
MoveToVersion	string	任意	シークレットのバージョン番号。このパラメーターは、VersionStage で設定されたバージョンステージがこのバージョンにアタッチされることを指定します。説明 RemoveFromVersion と MoveToVersion の少なくとも 1 つを指定する必要があります。 VersionStage を ACSCurrent または ACSPrevious に設定する場合は、このパラメーターを指定する必要があります。	002

レスポンスパラメーター

パラメーター	タイプ	説明	例
	object
SecretName	string	シークレットの名前。	secret001
RequestId	string	リクエスト ID。Alibaba Cloud はリクエストごとに一意の ID を生成します。この ID を使用して問題のトラブルシューティングを行うことができます。	8cad259f-4d77-40ec-bbd7-b9c47a423bb9

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidParameter	some of the specified parameters "\" is not valid
400	Rejected.LimitExceeded	exceed secret limits error
400	Rejected.InvalidRequest	param mismatch
400	Rejected.UnsupportedOperation	secret stages in unnormal status
500	InternalFailure	Internal Failure
403	Forbidden.NoPermission	This operation is forbidden by permission system
404	Forbidden.ResourceNotFound	Resource not found
409	Rejected.ResourceInDeleteWindow	secret in delete peroid

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。