調用ListSecretVersionIds介面查詢憑據的所有版本資訊。
版本資訊中不包含憑據值。預設只返回有版本狀態的憑據版本。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
|
名稱 |
類型 |
是否必選 |
樣本值 |
描述 |
| Action | String | 是 | ListSecretVersionIds | 要執行的操作。取值:ListSecretVersionIds。 |
| SecretName | String | 是 | secret001 | 憑據名稱或憑據資源名稱(ARN)。 說明 訪問其他阿里雲帳號下的憑據時,必須輸入憑據ARN。憑據ARN的格式為 acs:kms:${region}:${account}:secret/${secret-name}。 |
| IncludeDeprecated | String | 否 | false | 傳回值中是否包含沒有版本狀態的憑據版本。 取值範圍:
|
| PageNumber | Integer | 否 | 1 | 分頁查詢時,設定當前頁面的頁碼。預設值:1。 |
| PageSize | Integer | 否 | 10 | 分頁查詢時,設定每頁大小。預設值:20。 |
返回資料
名稱 |
類型 |
樣本值 |
描述 |
| SecretName | String | secret001 | 憑據名稱。 |
| RequestId | String | 5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47 | 本次調用請求的ID,是由阿里雲為該請求產生的唯一識別碼,可用於排查和定位問題。 |
| PageSize | Integer | 10 | 當前頁大小。 |
| PageNumber | Integer | 1 | 當前頁碼。 |
| TotalCount | Integer | 1 | 清單項目總個數。 |
| VersionIds | Array of VersionId | 憑據的版本資訊列表。 |
|
| VersionId | |||
| VersionId | String | v1 | 版本號碼。 |
| CreateTime | String | 2024-02-21T15:39:26Z | 版本的建立時間。 |
| VersionStages | Array of String | {"VersionStage": ["ACSCurrent","uStage1"]} | 版本的狀態標記。 |
樣本
請求樣本
http(s)://[Endpoint]/?Action=ListSecretVersionIds
&SecretName=secret001
&IncludeDeprecated=false
&PageNumber=1
&PageSize=10
&公用請求參數
正常返回樣本
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListSecretVersionIdsResponse>
<SecretName>secret001</SecretName>
<RequestId>5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47</RequestId>
<PageSize>10</PageSize>
<PageNumber>1</PageNumber>
<TotalCount>1</TotalCount>
<VersionIds>
<VersionId>v1</VersionId>
<CreateTime>2024-02-21T15:39:26Z</CreateTime>
<VersionStages>{"VersionStage": ["ACSCurrent","uStage1"]}</VersionStages>
</VersionIds>
</ListSecretVersionIdsResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"SecretName" : "secret001",
"RequestId" : "5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47",
"PageSize" : 10,
"PageNumber" : 1,
"TotalCount" : 1,
"VersionIds" : [ {
"VersionId" : "v1",
"CreateTime" : "2024-02-21T15:39:26Z",
"VersionStages" : [ "{\"VersionStage\": [\"ACSCurrent\",\"uStage1\"]}" ]
} ]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。