调用ListKeyVersions接口列出主密钥的所有密钥版本。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListKeyVersions |
要执行的操作,取值:ListKeyVersions。 |
KeyId | String | 是 | 0b30658a-ed1a-4922-b8f7-a673ca9c**** |
主密钥(CMK)的全局唯一标识符。该参数也可以被指定为CMK绑定的别名,详情请参见别名使用说明。 |
PageNumber | Integer | 是 | 1 |
当前页数。 取值为大于0的整数。 默认值:1。 |
PageSize | Integer | 否 | 10 |
每页返回的结果个数。 取值范围:0~101。 默认值:10。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
KeyVersions | Array |
返回的密钥版本数组。 |
|
KeyVersion | |||
CreationDate | String | 2016-03-25T10:42:40Z |
创建密钥版本时的日期和时间(UTC时间)。 |
KeyId | String | 0b30658a-ed1a-4922-b8f7-a673ca9c**** |
CMK的全局唯一标识符。 说明 如果请求中的KeyId参数使用的是CMK的别名,在响应中会返回别名对应的CMK标识符。
|
KeyVersionId | String | 1e3304fd-68ac-4d5b-8886-ae5f01a1**** |
密钥版本的全局唯一标识符。 |
PageNumber | Integer | 1 |
当前页数。 |
PageSize | Integer | 10 |
每页的返回结果个数。 |
RequestId | String | f71204c4-53cd-4eea-b405-653ba2db7e86 |
本次请求的ID。 |
TotalCount | Integer | 3 |
返回的密钥版本总数。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListKeyVersions
&KeyId=1234abcd-12ab-34cd-56ef-12345678****
&PageNumber=1
&<公共请求参数>
正常返回示例
XML
格式
<KMS>
<RequestId>f71204c4-53cd-4eea-b405-653ba2db7e86</RequestId>
<KeyVersions>
<KeyVersion>
<KeyId>0b30658a-ed1a-4922-b8f7-a673ca9c****</KeyId>
<KeyVersionId>1e3304fd-68ac-4d5b-8886-ae5f01a1****</KeyVersionId>
<CreationDate>2019-08-06T10:22:03Z</CreationDate>
</KeyVersion>
<KeyVersion>
<KeyId>0b30658a-ed1a-4922-b8f7-a673ca9c****</KeyId>
<KeyVersionId>2ab1a983-7072-4bbc-a582-584b5bd8****</KeyVersionId>
<CreationDate>2019-08-06T10:19:18Z</CreationDate>
</KeyVersion>
<KeyVersion>
<KeyId>0b30658a-ed1a-4922-b8f7-a673ca9c****</KeyId>
<KeyVersionId>6a69c763-388a-4708-9fc0-4322266b****</KeyVersionId>
<CreationDate>2019-08-06T10:17:04Z</CreationDate>
</KeyVersion>
</KeyVersions>
<TotalCount>3</TotalCount>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
</KMS>
JSON
格式
{
"KMS": {
"RequestId": "f71204c4-53cd-4eea-b405-653ba2db7e86",
"KeyVersions": {
"KeyVersion": [
{
"KeyId": "0b30658a-ed1a-4922-b8f7-a673ca9c****",
"KeyVersionId": "1e3304fd-68ac-4d5b-8886-ae5f01a1****",
"CreationDate": "2019-08-06T10:22:03Z"
},
{
"KeyId": "0b30658a-ed1a-4922-b8f7-a673ca9c****",
"KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
"CreationDate": "2019-08-06T10:19:18Z"
},
{
"KeyId": "0b30658a-ed1a-4922-b8f7-a673ca9c****",
"KeyVersionId": "6a69c763-388a-4708-9fc0-4322266b****",
"CreationDate": "2019-08-06T10:17:04Z"
}
]
},
"TotalCount": 3,
"PageNumber": 1,
"PageSize": 10
}
}
错误码
访问错误中心查看更多错误码。