UpdateSecretVersionStage
調(diào)用UpdateSecretVersionStage接口更新通用憑據(jù)的版本狀態(tài)。
本接口僅支持通用憑據(jù)，支持以下操作：
- 為指定的憑據(jù)版本新增一個(gè)版本狀態(tài)。
- 將指定的憑據(jù)版本的版本狀態(tài)移除。
- 將指定的憑據(jù)版本的版本狀態(tài)移除，并綁定到其他憑據(jù)版本上。
本文將提供一個(gè)示例，更新名為secret001憑據(jù)的版本狀態(tài)，將ACSCurrent版本狀態(tài)用于標(biāo)記002版本。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
|
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
| Action | String | 是 | UpdateSecretVersionStage | 要執(zhí)行的操作。取值：UpdateSecretVersionStage。 |
| SecretName | String | 是 | secret001 | 憑據(jù)名稱或憑據(jù)資源名稱（ARN）。 說明 訪問其他阿里云賬號(hào)下的憑據(jù)時(shí)，必須輸入憑據(jù)ARN。憑據(jù)ARN的格式為 acs:kms:${region}:${account}:secret/${secret-name}。 |
| VersionStage | String | 是 | ACSCurrent | 憑據(jù)的版本狀態(tài)。 場景一：為指定的憑據(jù)版本新增一個(gè)版本狀態(tài)。輸入本參數(shù)、MoveToVersion，不輸入RemoveFromVersion。本參數(shù)取值為ACSCurrent 、ACSPrevious或自定義狀態(tài)。 場景二：將指定的憑據(jù)版本的版本狀態(tài)移除。輸入本參數(shù)、RemoveFromVersion，不輸入MoveToVersion。本參數(shù)取值為自定義狀態(tài)。 說明 ACSCurrent 、ACSPrevious為系統(tǒng)內(nèi)置狀態(tài)，不允許直接移除，只能從一個(gè)憑據(jù)版本移除并綁定到另一個(gè)憑據(jù)版本。 輸入本參數(shù)、MoveToVersion、RemoveFromVersion。本參數(shù)取值為ACSCurrent 、ACSPrevious或自定義狀態(tài)。 |
| RemoveFromVersion | String | 否 | 001 | 憑據(jù)版本的版本號(hào)。表示將入?yún)ersionStage指定的版本狀態(tài)從該版本號(hào)移除。 說明 RemoveFromVersion和MoveToVersion至少指定其中一個(gè)參數(shù)。 |
| MoveToVersion | String | 否 | 002 | 憑據(jù)版本的版本號(hào)。表示將入?yún)ersionStage指定的版本狀態(tài)綁定到該版本號(hào)。 說明
|
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
| SecretName | String | secret001 | 憑據(jù)名稱。 |
| RequestId | String | 8cad259f-4d77-40ec-bbd7-b9c47a423bb9 | 本次調(diào)用請(qǐng)求的ID，是由阿里云為該請(qǐng)求生成的唯一標(biāo)識(shí)符，可用于排查和定位問題。 |
示例
請(qǐng)求示例
http(s)://[Endpoint]/?Action=UpdateSecretVersionStage
&SecretName=secret001
&VersionStage=ACSCurrent
&RemoveFromVersion=001
&MoveToVersion=002
&公共請(qǐng)求參數(shù)正常返回示例
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"
}錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。