租户端安全密钥管理系统（KMS）数据结构

数据结构

最近更新时间: 2026-04-09 18:11:30

KeyMetadata

CMK属性信息

被如下接口引用：DescribeKey、DescribeKeys、ListKeyDetail

名称	必选	允许NULL	类型	描述
KeyId	是	否	String	CMK的全局唯一标识示例值：
Alias	是	否	String	作为密钥更容易辨识，更容易被人看懂的别名示例值：
CreateTime	是	否	Uint64	密钥创建时间示例值：
Description	是	否	String	CMK的描述示例值：
KeyState	是	否	String	CMK的状态，取值为：Enabled
KeyUsage	是	否	String	CMK用途，取值为: ENCRYPT_DECRYPT
Type	是	否	Int64	CMK类型，2 表示符合FIPS标准，4表示符合国密标准示例值：
CreatorUin	是	否	Uint64	创建者示例值：
KeyRotationEnabled	是	否	Bool	是否开启了密钥轮换功能示例值：
Owner	是	否	String	CMK的创建者，用户创建的为 user，授权各云产品自动创建的为对应的产品名示例值：
NextRotateTime	是	否	Uint64	在密钥轮换开启状态下，下次轮换的时间示例值：
DeletionDate	是	是	Uint64	计划删除的时间示例值：
Origin	是	是	String	CMK 密钥材料类型，由KMS创建的为： TENCENT_KMS，由用户导入的类型为：EXTERNAL 示例值：
ValidTo	是	是	Uint64	在Origin为 EXTERNAL 时有效，表示密钥材料的有效日期， 0 表示不过期示例值：
ResourceId	是	否	String	资源ID，格式：creatorUin/$creatorUin/$keyId 示例值：
RotateDays	否	是	Uint64	轮换天数示例值：
LastRotateTime	否	是	Uint64	上一次轮换的时间示例值：

标签过滤器

被如下接口引用：DescribeWhiteBoxKeyDetails、ListKeyDetail

名称	必选	允许NULL	类型	描述
TagKey	是	否	String	标签键示例值：
TagValue	否	否	Array of String	标签值示例值：

返回CMK列表信息

被如下接口引用：ListKeys

名称	必选	允许NULL	类型	描述
KeyId	是	否	String	CMK的全局唯一标识。示例值：

白盒密钥信息

被如下接口引用：DescribeWhiteBoxKey、DescribeWhiteBoxKeyDetails

名称	必选	允许NULL	类型	描述
KeyId	是	否	String	白盒密钥的全局唯一标识符示例值：
Alias	是	否	String	作为密钥更容易辨识，更容易被人看懂的别名，不可为空，1-60个字母数字 - _ 的组合，首字符必须为字母或者数字. 不可重复示例值：
CreatorUin	是	否	Uint64	创建者示例值：
Description	是	否	String	密钥的描述信息示例值：
CreateTime	是	否	Uint64	密钥创建时间，Unix时间戳示例值：
Status	是	否	String	白盒密钥的状态，取值为：Enabled
OwnerUin	是	否	Uint64	创建者示例值：
Algorithm	是	否	String	密钥所用的算法类型示例值：
EncryptKey	是	否	String	白盒加密密钥，base64编码示例值：
DecryptKey	是	否	String	白盒解密密钥，base64编码示例值：
ResourceId	是	否	String	资源ID，格式：creatorUin/$creatorUin/$keyId 示例值：
DeviceFingerprintBind	是	是	Bool	是否有设备指纹与当前密钥绑定示例值：

标签键和标签值

被如下接口引用：CreateKey、CreateWhiteBoxKey

名称	必选	允许NULL	类型	描述
TagKey	是	否	String	标签键示例值：
TagValue	是	否	String	标签值示例值：

TSM SDK授权License

被如下接口引用：DescribeTSMLicenses

名称	必选	允许NULL	类型	描述
Version	否	否	String	License版本示例值：
TsmAppId	否	否	String	TSM AppId 示例值：
Cert	否	否	String	证书，这里返回的是字符串格式示例值：

算法的名称和标识

被如下接口引用：ListAlgorithms

名称	必选	允许NULL	类型	描述
KeyUsage	是	否	String	算法的标识示例值：
Algorithm	是	否	String	算法的名称示例值：

设备指纹

被如下接口引用：DescribeWhiteBoxDeviceFingerprints、OverwriteWhiteBoxDeviceFingerprints

名称	必选	允许NULL	类型	描述
Identity	是	否	String	指纹信息，由设备指纹采集工具采集获得，格式满足正则表达式：^[0-9a-f]{8}[-][0-9a-f]{14}[-][0-9a-f]{14}[-][0-9a-f]{14}[-][0-9a-f]{16}$ 示例值：
Description	否	是	String	描述信息，如：IP，设备名称等，最大1024字节示例值：