获取主密钥属性

最近更新时间:2019-12-05 18:46:29

我的收藏

1. 接口描述

本接口(GetKeyAttributes)用于返回指定 KeyId 的属性信息。
kms请求域名接口和说明可参考 地域和域名说明
Note:
任何时候,包括内测期间,如果使用外网域名产生公网下行流量,都会收取流量费用。 所以强烈建议服务在腾讯云上的用户使用内网域名,内网不会产生流量费用。
输入参数有些是可选的,不填取默认值。
输出参数在成功情况下所有出参都会返回给用户。失败情况下,至少会有 code,message,requestId 返回。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见 公共请求参数 页面。
参数名称
是否必选
类型
描述
keyId
String
调用 CreateKey 生成的 CMK 全局唯一标识符。

3. 输出参数

参数名称
类型
描述
code
Int
请参考 错误码
message
String
错误提示信息。
requestId
String
服务器生成的请求 ID。出现服务器内部错误时,用户可提交此 ID 给后台定位问题。
keyMetadata
Struct
密钥信息。
keyMetadata定义如下:
参数名称
类型
描述
取值
备注
keyId
String
key 的全局唯一标识符
-
-
alias
String
作为密钥更容易辨识,更容易被人看懂的别名。
可为空。0-32个字符。
-
createTime
Uint32
密钥创建时间
时间戳
-
description
String
key 的描述
key 的描述
-
keyState
String
key 的状态
Enabled 或者 Disabled
-
keyUsage
String
key 的用途
ENCRYPT/DECRYPT
-
type
Int
指定key类型,1为普通类型,2为量子类型。
-
-

4. 示例

输入

https://kms-gz.api.tencentyun.com/v2/index.php?Action=GetKeyAttributes
&keyId=kms-345sdfk

输出

{
"code" : 0,
"message" : "",
"requestId":"14534664555",
"keyMetadata": {
"keyId": "kms-345sdfk",
"createTime":1483945424,
"description": "test",
"keyState": "Enabled",
"keyUsage": "ENCRYPT/DECRYPT",
"type": 1
}
}