调用DescribeKeyVersion接口查询指定密钥版本信息。
本文将提供一个示例,为您查询密钥1234abcd-12ab-34cd-56ef-12345678****
的密钥版本信息,密钥版本ID为2ab1a983-7072-4bbc-a582-584b5bd8****
。返回结果显示,密钥版本的创建时间为2016-03-25T10:42:40Z
。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeKeyVersion |
要执行的操作,取值:DescribeKeyVersion。 |
KeyId | String | 是 | 1234abcd-12ab-34cd-56ef-12345678**** |
主密钥(CMK)的全局唯一标识符。 该参数也可以被指定为CMK绑定的别名。更多信息,请参见别名使用说明。 |
KeyVersionId | String | 是 | 2ab1a983-7072-4bbc-a582-584b5bd8**** |
密钥版本的全局唯一标识符。 您可以调用ListKeyVersions接口,获取KeyVersionId。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
KeyVersion | Struct |
密钥版本的元数据。 |
|
CreationDate | String | 2016-03-25T10:42:40Z |
创建密钥版本时的日期和时间(UTC时间)。 |
KeyId | String | 1234abcd-12ab-34cd-56ef-12345678**** |
CMK的全局唯一标识符。 说明 如果请求中的KeyId参数使用的是CMK的别名,在响应中会返回别名对应的CMK标识符。
|
KeyVersionId | String | 2ab1a983-7072-4bbc-a582-584b5bd8**** |
密钥版本的全局唯一标识符。 |
RequestId | String | 7021b6ec-4be7-4d3c-8a68-1e85d4d515a0 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeKeyVersion
&KeyId=1234abcd-12ab-34cd-56ef-12345678****
&KeyVersionId=2ab1a983-7072-4bbc-a582-584b5bd8****
&<公共请求参数>
正常返回示例
XML
格式
<KMS>
<RequestId>7021b6ec-4be7-4d3c-8a68-1e85d4d515a0</RequestId>
<KeyVersion>
<CreationDate>2016-03-25T10:42:40Z</CreationDate>
<KeyId>1234abcd-12ab-34cd-56ef-12345678****</KeyId>
<KeyVersionId>2ab1a983-7072-4bbc-a582-584b5bd8****</KeyVersionId>
</KeyVersion>
</KMS>
JSON
格式
{
"RequestId":"7021b6ec-4be7-4d3c-8a68-1e85d4d515a0",
"KeyVersion":{
"CreationDate":"2016-03-25T10:42:40Z",
"KeyId":"1234abcd-12ab-34cd-56ef-12345678****",
"KeyVersionId":"2ab1a983-7072-4bbc-a582-584b5bd8****"
}
}
错误码
访问错误中心查看更多错误码。