調用ListKeyVersions接口列出主密鑰的所有密鑰版本。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ListKeyVersions | 要執行的操作。取值:ListKeyVersions。 |
KeyId | String | 是 | key-hzz630494463ejqjx**** | 密鑰的ID,也可以指定為密鑰別名或密鑰資源名稱(ARN)。關于別名的詳細介紹,請參見管理密鑰別名。 說明 訪問其他阿里云賬號下的密鑰時,必須輸入密鑰ARN。密鑰ARN的格式為 acs:kms:${region}:${account}:key/${keyid} 。 |
PageNumber | Integer | 是 | 1 | 當前頁數。 取值為大于0的整數。 默認值:1。 |
PageSize | Integer | 否 | 10 | 每頁返回的結果個數。 取值范圍:0~101。 默認值:10。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
PageSize | Integer | 10 | 每頁的返回結果個數。 |
RequestId | String | f71204c4-53cd-4eea-b405-653ba2db7e86 | 本次調用請求的ID,是由阿里云為該請求生成的唯一標識符,可用于排查和定位問題。 |
PageNumber | Integer | 1 | 當前頁數。 |
TotalCount | Integer | 3 | 返回的密鑰版本總數。 |
KeyVersions | Array of KeyVersion | 返回的密鑰版本數組。 |
|
KeyVersion | |||
KeyId | String | key-hzz630494463ejqjx**** | 密鑰ID。如果請求中的KeyId參數使用的是密鑰別名、密鑰ARN,在響應中也會返回密鑰ID。 |
KeyVersionId | String | 1e3304fd-68ac-4d5b-8886-ae5f01a1**** | 密鑰版本的全局唯一標識符。 |
CreationDate | String | 2024-03-25T10:42:40Z | 創建密鑰版本時的日期和時間(UTC時間)。 |
示例
請求示例
http(s)://[Endpoint]/?Action=ListKeyVersions
&KeyId=key-hzz630494463ejqjx****
&PageNumber=1
&PageSize=10
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListKeyVersionsResponse>
<PageSize>10</PageSize>
<RequestId>f71204c4-53cd-4eea-b405-653ba2db7e86</RequestId>
<PageNumber>1</PageNumber>
<TotalCount>3</TotalCount>
<KeyVersions>
<KeyId>key-hzz630494463ejqjx****</KeyId>
<KeyVersionId>1e3304fd-68ac-4d5b-8886-ae5f01a1****</KeyVersionId>
<CreationDate>2024-03-25T10:42:40Z</CreationDate>
</KeyVersions>
</ListKeyVersionsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"PageSize" : 10,
"RequestId" : "f71204c4-53cd-4eea-b405-653ba2db7e86",
"PageNumber" : 1,
"TotalCount" : 3,
"KeyVersions" : [ {
"KeyId" : "key-hzz630494463ejqjx****",
"KeyVersionId" : "1e3304fd-68ac-4d5b-8886-ae5f01a1****",
"CreationDate" : "2024-03-25T10:42:40Z"
} ]
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 | InvalidParameter | The specified parameter is not valid. | 參數非法。 |
404 | Forbidden.KeyNotFound | The specified Key is not found. | 指定的密鑰不存在。 |
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?