全部产品

密钥管理服务：API概览

更新时间：Aug 18, 2023

本文介绍KMS实例API提供的API接口及相关描述。

密钥接口

使用KMS提供的密钥接口前，请关注以下信息：

AdvanceEncrypt、AdvanceDecrypt、AdvanceGenerateDataKey和GenerateDataKey：KMS密钥应为对称密钥。
Encrypt和Decrypt：KMS密钥可以为对称密钥，也可以为非对称密钥。
Sign、Verify和GetPublicKey：KMS密钥应为非对称密钥。

API	描述
AdvanceEncrypt	用于将明文数据通过KMS密钥加密为密文。重要如果密钥开启了自动轮转，请您使用AdvanceEncrypt、AdvanceDecrypt和AdvanceGenerateDataKey接口，以避免轮转功能不生效。关于密钥轮转的相关内容，请参见密钥轮转。您需要存储密文（CiphertextBlob）和认证数据（Aad），然后使用AdvanceDecrypt解密。
AdvanceDecrypt	将使用KMS密钥加密的密文解密为明文。
AdvanceGenerateDataKey	用于生成数据密钥，对数据按照KMS信封加密方式加密。重要您需要存储密文（CiphertextBlob）和认证数据（Aad），然后使用AdvanceDecrypt解密。
Encrypt	用于将明文数据通过KMS密钥加密为密文。重要您需要存储密钥的全局唯一标识符（KeyId）、密文（CiphertextBlob）、加密算法（Algorithm）、初始向量（Iv）、填充模式（PaddingMode）和认证数据（Aad），然后使用Decrypt或AdvanceDecrypt解密。
Decrypt	将使用KMS密钥加密的密文解密为明文。
GenerateDataKey	用于生成数据密钥，对数据按照KMS信封加密方式加密。
Sign	使用非对称密钥进行签名。重要您可以通过Verify接口验证签名，也可获取公钥（GetPublicKey）到本地自行验证签名。
Verify	使用非对称密钥进行验签。
GetPublicKey	获取指定非对称密钥的公钥。

凭据接口

API	描述
GetSecretValue	获取凭据值。

其他接口

API	描述
GenerateRandom	生成一个随机数。