調用UpdateSecretVersionStage接口更新通用憑據的版本狀態。
本接口僅支持通用憑據,支持以下操作:
- 為指定的憑據版本新增一個版本狀態。
- 將指定的憑據版本的版本狀態移除。
- 將指定的憑據版本的版本狀態移除,并綁定到其他憑據版本上。
本文將提供一個示例,更新名為secret001
憑據的版本狀態,將ACSCurrent
版本狀態用于標記002
版本。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | UpdateSecretVersionStage | 要執行的操作。取值:UpdateSecretVersionStage。 |
SecretName | String | 是 | secret001 | 憑據名稱或憑據資源名稱(ARN)。 說明 訪問其他阿里云賬號下的憑據時,必須輸入憑據ARN。憑據ARN的格式為 acs:kms:${region}:${account}:secret/${secret-name} 。 |
VersionStage | String | 是 | ACSCurrent | 憑據的版本狀態。 場景一:為指定的憑據版本新增一個版本狀態。輸入本參數、MoveToVersion,不輸入RemoveFromVersion。本參數取值為ACSCurrent 、ACSPrevious或自定義狀態。 場景二:將指定的憑據版本的版本狀態移除。輸入本參數、RemoveFromVersion,不輸入MoveToVersion。本參數取值為自定義狀態。 說明 ACSCurrent 、ACSPrevious為系統內置狀態,不允許直接移除,只能從一個憑據版本移除并綁定到另一個憑據版本。 輸入本參數、MoveToVersion、RemoveFromVersion。本參數取值為ACSCurrent 、ACSPrevious或自定義狀態。 |
RemoveFromVersion | String | 否 | 001 | 憑據版本的版本號。表示將入參VersionStage指定的版本狀態從該版本號移除。 說明 RemoveFromVersion和MoveToVersion至少指定其中一個參數。 |
MoveToVersion | String | 否 | 002 | 憑據版本的版本號。表示將入參VersionStage指定的版本狀態綁定到該版本號。 說明
|
返回數據
名稱 |
類型 |
示例值 |
描述 |
SecretName | String | secret001 | 憑據名稱。 |
RequestId | String | 8cad259f-4d77-40ec-bbd7-b9c47a423bb9 | 本次調用請求的ID,是由阿里云為該請求生成的唯一標識符,可用于排查和定位問題。 |
示例
請求示例
http(s)://[Endpoint]/?Action=UpdateSecretVersionStage
&SecretName=secret001
&VersionStage=ACSCurrent
&RemoveFromVersion=001
&MoveToVersion=002
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateSecretVersionStageResponse>
<SecretName>secret001</SecretName>
<RequestId>8cad259f-4d77-40ec-bbd7-b9c47a423bb9</RequestId>
</UpdateSecretVersionStageResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"SecretName" : "secret001",
"RequestId" : "8cad259f-4d77-40ec-bbd7-b9c47a423bb9"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?