UpdateSecretVersionStage - 更新憑據的版本狀態 -

介面說明

RAM 使用者或 RAM 角色調用該 OpenAPI 需要被授與權限策略詳情，請參見存取控制。
本介面僅支援通用憑據，支援以下操作：
- 為指定的憑據版本新增一個版本狀態。
- 將指定的憑據版本的版本狀態移除。
- 將指定的憑據版本的版本狀態移除，並綁定到其他憑據版本上。
每個通用憑據的版本狀態總數不能超過 8 個。

本文將提供一個樣本，更新名為secret001憑據的版本狀態，將ACSCurrent版本狀態用於標記002版本。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱	類型	必填	描述	樣本值
SecretName	string	是	憑據名稱或憑據資源名稱（ARN）。說明訪問其他阿里雲帳號下的憑據時，必須輸入憑據 ARN。憑據 ARN 的格式：`acs:kms:${region}:${account}:secret/${secret-name}`。	secret001
VersionStage	string	是	憑據的版本狀態。情境一：為指定的憑據版本新增一個版本狀態。輸入本參數、MoveToVersion，不輸入 RemoveFromVersion。本參數取值為 ACSCurrent 、ACSPrevious 或自訂狀態。情境二：將指定的憑據版本的版本狀態移除。輸入本參數、RemoveFromVersion，不輸入 MoveToVersion。本參數取值為自訂狀態。說明 ACSCurrent 、ACSPrevious 為系統內建狀態，不允許直接移除，只能從一個憑據版本移除並綁定到另一個憑據版本。情境三：將指定的憑據版本的版本狀態移除，並綁定到其他憑據版本。輸入本參數、MoveToVersion、RemoveFromVersion。本參數取值為 ACSCurrent 、ACSPrevious 或自訂狀態。	ACSCurrent
RemoveFromVersion	string	否	憑據版本的版本號碼。表示將入參 VersionStage 指定的版本狀態從該版本號碼移除。說明 RemoveFromVersion 和 MoveToVersion 至少指定其中一個參數。	001
MoveToVersion	string	否	憑據版本的版本號碼。表示將入參 VersionStage 指定的版本狀態綁定到該版本號碼。說明 RemoveFromVersion 和 MoveToVersion 至少指定其中一個參數。當 VersionStage 取值為 ACSCurrent 或 ACSPrevious 時，必須指定本參數。	002

返回參數

名稱	類型	描述	樣本值
	object
SecretName	string	憑據名稱。	secret001
RequestId	string	本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。	8cad259f-4d77-40ec-bbd7-b9c47a423bb9

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
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

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。