调用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****"
        }
}

错误码

访问错误中心查看更多错误码。