KmsClient (tencentcloud-sdk-java 3.0.120 API)

java.lang.Object
- com.tencentcloudapi.common.AbstractClient
- - com.tencentcloudapi.kms.v20190118.KmsClient

public class KmsClient
extends AbstractClient

字段概要
- 从类继承的字段 com.tencentcloudapi.common.AbstractClient
  gson, HTTP_RSP_OK, SDK_VERSION

构造器概要

构造器
构造器和说明

KmsClient(Credential credential, String region)

KmsClient(Credential credential, String region, ClientProfile profile)

构造器
构造器和说明
`KmsClient(Credential credential, String region)`
`KmsClient(Credential credential, String region, ClientProfile profile)`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`CancelKeyDeletionResponse`	`CancelKeyDeletion(CancelKeyDeletionRequest req)` 取消CMK的计划删除操作
`CreateKeyResponse`	`CreateKey(CreateKeyRequest req)` 创建用户管理数据密钥的主密钥CMK（Custom Master Key）。
`DecryptResponse`	`Decrypt(DecryptRequest req)` 本接口用于解密密文，得到明文数据。
`DeleteImportedKeyMaterialResponse`	`DeleteImportedKeyMaterial(DeleteImportedKeyMaterialRequest req)` 用于删除导入的密钥材料，仅对EXTERNAL类型的CMK有效，该接口将CMK设置为PendingImport 状态，并不会删除CMK，在重新进行密钥导入后可继续使用。
`DescribeKeyResponse`	`DescribeKey(DescribeKeyRequest req)` 用于获取指定KeyId的主密钥属性详情信息。
`DescribeKeysResponse`	`DescribeKeys(DescribeKeysRequest req)` 该接口用于批量获取主密钥属性信息。
`DisableKeyResponse`	`DisableKey(DisableKeyRequest req)` 本接口用于禁用一个主密钥，处于禁用状态的Key无法用于加密、解密操作。
`DisableKeyRotationResponse`	`DisableKeyRotation(DisableKeyRotationRequest req)` 对指定的CMK禁止密钥轮换功能。
`DisableKeysResponse`	`DisableKeys(DisableKeysRequest req)` 该接口用于批量禁止CMK的使用。
`EnableKeyResponse`	`EnableKey(EnableKeyRequest req)` 用于启用一个指定的CMK。
`EnableKeyRotationResponse`	`EnableKeyRotation(EnableKeyRotationRequest req)` 对指定的CMK开启密钥轮换功能。
`EnableKeysResponse`	`EnableKeys(EnableKeysRequest req)` 该接口用于批量启用CMK。
`EncryptResponse`	`Encrypt(EncryptRequest req)` 本接口用于加密最多为4KB任意数据，可用于加密数据库密码，RSA Key，或其它较小的敏感信息。
`GenerateDataKeyResponse`	`GenerateDataKey(GenerateDataKeyRequest req)` 本接口生成一个数据密钥，您可以用这个密钥进行本地数据的加密。
`GenerateRandomResponse`	`GenerateRandom(GenerateRandomRequest req)` 随机数生成接口。
`GetKeyRotationStatusResponse`	`GetKeyRotationStatus(GetKeyRotationStatusRequest req)` 查询指定的CMK是否开启了密钥轮换功能。
`GetParametersForImportResponse`	`GetParametersForImport(GetParametersForImportRequest req)` 获取导入主密钥（CMK）材料的参数，返回的Token作为执行ImportKeyMaterial的参数之一，返回的PublicKey用于对自主导入密钥材料进行加密。
`GetServiceStatusResponse`	`GetServiceStatus(GetServiceStatusRequest req)` 用于查询该用户是否已开通KMS服务
`ImportKeyMaterialResponse`	`ImportKeyMaterial(ImportKeyMaterialRequest req)` 用于导入密钥材料。
`ListKeyDetailResponse`	`ListKeyDetail(ListKeyDetailRequest req)` 根据指定Offset和Limit获取主密钥列表详情。
`ListKeysResponse`	`ListKeys(ListKeysRequest req)` 列出账号下面状态为Enabled， Disabled 和 PendingImport 的CMK KeyId 列表
`ReEncryptResponse`	`ReEncrypt(ReEncryptRequest req)` 使用指定CMK对密文重新加密。
`ScheduleKeyDeletionResponse`	`ScheduleKeyDeletion(ScheduleKeyDeletionRequest req)` CMK计划删除接口，用于指定CMK删除的时间，可选时间区间为[7,30]天
`UpdateAliasResponse`	`UpdateAlias(UpdateAliasRequest req)` 用于修改CMK的别名。
`UpdateKeyDescriptionResponse`	`UpdateKeyDescription(UpdateKeyDescriptionRequest req)` 该接口用于对指定的cmk修改描述信息。

从类继承的方法 com.tencentcloudapi.common.AbstractClient
call, getClientProfile, getCredential, getRegion, internalRequest, setClientProfile, setCredential, setRegion

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - KmsClient
```
public KmsClient(Credential credential,
                 String region)
```
  - KmsClient
```
public KmsClient(Credential credential,
                 String region,
                 ClientProfile profile)
```
- 方法详细资料
  - CancelKeyDeletion
```
public CancelKeyDeletionResponse CancelKeyDeletion(CancelKeyDeletionRequest req)
                                            throws TencentCloudSDKException
```
    取消CMK的计划删除操作
    
    参数:
    
    req - CancelKeyDeletionRequest
    
    返回:
    
    CancelKeyDeletionResponse
    
    抛出:
    
    TencentCloudSDKException
  - CreateKey
```
public CreateKeyResponse CreateKey(CreateKeyRequest req)
                            throws TencentCloudSDKException
```
    创建用户管理数据密钥的主密钥CMK（Custom Master Key）。
    
    参数:
    
    req - CreateKeyRequest
    
    返回:
    
    CreateKeyResponse
    
    抛出:
    
    TencentCloudSDKException
  - Decrypt
```
public DecryptResponse Decrypt(DecryptRequest req)
                        throws TencentCloudSDKException
```
    本接口用于解密密文，得到明文数据。
    
    参数:
    
    req - DecryptRequest
    
    返回:
    
    DecryptResponse
    
    抛出:
    
    TencentCloudSDKException
  - DeleteImportedKeyMaterial
```
public DeleteImportedKeyMaterialResponse DeleteImportedKeyMaterial(DeleteImportedKeyMaterialRequest req)
                                                            throws TencentCloudSDKException
```
    用于删除导入的密钥材料，仅对EXTERNAL类型的CMK有效，该接口将CMK设置为PendingImport 状态，并不会删除CMK，在重新进行密钥导入后可继续使用。彻底删除CMK请使用 ScheduleKeyDeletion 接口。
    
    参数:
    
    req - DeleteImportedKeyMaterialRequest
    
    返回:
    
    DeleteImportedKeyMaterialResponse
    
    抛出:
    
    TencentCloudSDKException
  - DescribeKey
```
public DescribeKeyResponse DescribeKey(DescribeKeyRequest req)
                                throws TencentCloudSDKException
```
    用于获取指定KeyId的主密钥属性详情信息。
    
    参数:
    
    req - DescribeKeyRequest
    
    返回:
    
    DescribeKeyResponse
    
    抛出:
    
    TencentCloudSDKException
  - DescribeKeys
```
public DescribeKeysResponse DescribeKeys(DescribeKeysRequest req)
                                  throws TencentCloudSDKException
```
    该接口用于批量获取主密钥属性信息。
    
    参数:
    
    req - DescribeKeysRequest
    
    返回:
    
    DescribeKeysResponse
    
    抛出:
    
    TencentCloudSDKException
  - DisableKey
```
public DisableKeyResponse DisableKey(DisableKeyRequest req)
                              throws TencentCloudSDKException
```
    本接口用于禁用一个主密钥，处于禁用状态的Key无法用于加密、解密操作。
    
    参数:
    
    req - DisableKeyRequest
    
    返回:
    
    DisableKeyResponse
    
    抛出:
    
    TencentCloudSDKException
  - DisableKeyRotation
```
public DisableKeyRotationResponse DisableKeyRotation(DisableKeyRotationRequest req)
                                              throws TencentCloudSDKException
```
    对指定的CMK禁止密钥轮换功能。
    
    参数:
    
    req - DisableKeyRotationRequest
    
    返回:
    
    DisableKeyRotationResponse
    
    抛出:
    
    TencentCloudSDKException
  - DisableKeys
```
public DisableKeysResponse DisableKeys(DisableKeysRequest req)
                                throws TencentCloudSDKException
```
    该接口用于批量禁止CMK的使用。
    
    参数:
    
    req - DisableKeysRequest
    
    返回:
    
    DisableKeysResponse
    
    抛出:
    
    TencentCloudSDKException
  - EnableKey
```
public EnableKeyResponse EnableKey(EnableKeyRequest req)
                            throws TencentCloudSDKException
```
    用于启用一个指定的CMK。
    
    参数:
    
    req - EnableKeyRequest
    
    返回:
    
    EnableKeyResponse
    
    抛出:
    
    TencentCloudSDKException
  - EnableKeyRotation
```
public EnableKeyRotationResponse EnableKeyRotation(EnableKeyRotationRequest req)
                                            throws TencentCloudSDKException
```
    对指定的CMK开启密钥轮换功能。
    
    参数:
    
    req - EnableKeyRotationRequest
    
    返回:
    
    EnableKeyRotationResponse
    
    抛出:
    
    TencentCloudSDKException
  - EnableKeys
```
public EnableKeysResponse EnableKeys(EnableKeysRequest req)
                              throws TencentCloudSDKException
```
    该接口用于批量启用CMK。
    
    参数:
    
    req - EnableKeysRequest
    
    返回:
    
    EnableKeysResponse
    
    抛出:
    
    TencentCloudSDKException
  - Encrypt
```
public EncryptResponse Encrypt(EncryptRequest req)
                        throws TencentCloudSDKException
```
    本接口用于加密最多为4KB任意数据，可用于加密数据库密码，RSA Key，或其它较小的敏感信息。对于应用的数据加密，使用GenerateDataKey生成的DataKey进行本地数据的加解密操作
    
    参数:
    
    req - EncryptRequest
    
    返回:
    
    EncryptResponse
    
    抛出:
    
    TencentCloudSDKException
  - GenerateDataKey
```
public GenerateDataKeyResponse GenerateDataKey(GenerateDataKeyRequest req)
                                        throws TencentCloudSDKException
```
    本接口生成一个数据密钥，您可以用这个密钥进行本地数据的加密。
    
    参数:
    
    req - GenerateDataKeyRequest
    
    返回:
    
    GenerateDataKeyResponse
    
    抛出:
    
    TencentCloudSDKException
  - GenerateRandom
```
public GenerateRandomResponse GenerateRandom(GenerateRandomRequest req)
                                      throws TencentCloudSDKException
```
    随机数生成接口。
    
    参数:
    
    req - GenerateRandomRequest
    
    返回:
    
    GenerateRandomResponse
    
    抛出:
    
    TencentCloudSDKException
  - GetKeyRotationStatus
```
public GetKeyRotationStatusResponse GetKeyRotationStatus(GetKeyRotationStatusRequest req)
                                                  throws TencentCloudSDKException
```
    查询指定的CMK是否开启了密钥轮换功能。
    
    参数:
    
    req - GetKeyRotationStatusRequest
    
    返回:
    
    GetKeyRotationStatusResponse
    
    抛出:
    
    TencentCloudSDKException
  - GetParametersForImport
```
public GetParametersForImportResponse GetParametersForImport(GetParametersForImportRequest req)
                                                      throws TencentCloudSDKException
```
    获取导入主密钥（CMK）材料的参数，返回的Token作为执行ImportKeyMaterial的参数之一，返回的PublicKey用于对自主导入密钥材料进行加密。返回的Token和PublicKey 24小时后失效，失效后如需重新导入，需要再次调用该接口获取新的Token和PublicKey。
    
    参数:
    
    req - GetParametersForImportRequest
    
    返回:
    
    GetParametersForImportResponse
    
    抛出:
    
    TencentCloudSDKException
  - GetServiceStatus
```
public GetServiceStatusResponse GetServiceStatus(GetServiceStatusRequest req)
                                          throws TencentCloudSDKException
```
    用于查询该用户是否已开通KMS服务
    
    参数:
    
    req - GetServiceStatusRequest
    
    返回:
    
    GetServiceStatusResponse
    
    抛出:
    
    TencentCloudSDKException
  - ImportKeyMaterial
```
public ImportKeyMaterialResponse ImportKeyMaterial(ImportKeyMaterialRequest req)
                                            throws TencentCloudSDKException
```
    用于导入密钥材料。只有类型为EXTERNAL 的CMK 才可以导入，导入的密钥材料使用 GetParametersForImport 获取的密钥进行加密。可以为指定的 CMK 重新导入密钥材料，并重新指定过期时间，但必须导入相同的密钥材料。CMK 密钥材料导入后不可以更换密钥材料。导入的密钥材料过期或者被删除后，指定的CMK将无法使用，需要再次导入相同的密钥材料才能正常使用。CMK是独立的，同样的密钥材料可导入不同的 CMK 中，但使用其中一个 CMK 加密的数据无法使用另一个 CMK解密。只有Enabled 和 PendingImport状态的CMK可以导入密钥材料。
    
    参数:
    
    req - ImportKeyMaterialRequest
    
    返回:
    
    ImportKeyMaterialResponse
    
    抛出:
    
    TencentCloudSDKException
  - ListKeyDetail
```
public ListKeyDetailResponse ListKeyDetail(ListKeyDetailRequest req)
                                    throws TencentCloudSDKException
```
    根据指定Offset和Limit获取主密钥列表详情。
    
    参数:
    
    req - ListKeyDetailRequest
    
    返回:
    
    ListKeyDetailResponse
    
    抛出:
    
    TencentCloudSDKException
  - ListKeys
```
public ListKeysResponse ListKeys(ListKeysRequest req)
                          throws TencentCloudSDKException
```
    列出账号下面状态为Enabled， Disabled 和 PendingImport 的CMK KeyId 列表
    
    参数:
    
    req - ListKeysRequest
    
    返回:
    
    ListKeysResponse
    
    抛出:
    
    TencentCloudSDKException
  - ReEncrypt
```
public ReEncryptResponse ReEncrypt(ReEncryptRequest req)
                            throws TencentCloudSDKException
```
    使用指定CMK对密文重新加密。
    
    参数:
    
    req - ReEncryptRequest
    
    返回:
    
    ReEncryptResponse
    
    抛出:
    
    TencentCloudSDKException
  - ScheduleKeyDeletion
```
public ScheduleKeyDeletionResponse ScheduleKeyDeletion(ScheduleKeyDeletionRequest req)
                                                throws TencentCloudSDKException
```
    CMK计划删除接口，用于指定CMK删除的时间，可选时间区间为[7,30]天
    
    参数:
    
    req - ScheduleKeyDeletionRequest
    
    返回:
    
    ScheduleKeyDeletionResponse
    
    抛出:
    
    TencentCloudSDKException
  - UpdateAlias
```
public UpdateAliasResponse UpdateAlias(UpdateAliasRequest req)
                                throws TencentCloudSDKException
```
    用于修改CMK的别名。对于处于PendingDelete状态的CMK禁止修改。
    
    参数:
    
    req - UpdateAliasRequest
    
    返回:
    
    UpdateAliasResponse
    
    抛出:
    
    TencentCloudSDKException
  - UpdateKeyDescription
```
public UpdateKeyDescriptionResponse UpdateKeyDescription(UpdateKeyDescriptionRequest req)
                                                  throws TencentCloudSDKException
```
    该接口用于对指定的cmk修改描述信息。对于处于PendingDelete状态的CMK禁止修改。
    
    参数:
    
    req - UpdateKeyDescriptionRequest
    
    返回:
    
    UpdateKeyDescriptionResponse
    
    抛出:
    
    TencentCloudSDKException

类 KmsClient

字段概要

从类继承的字段 com.tencentcloudapi.common.AbstractClient

构造器概要

方法概要

从类继承的方法 com.tencentcloudapi.common.AbstractClient

从类继承的方法 java.lang.Object

构造器详细资料

KmsClient

KmsClient

方法详细资料

CancelKeyDeletion

CreateKey

Decrypt

DeleteImportedKeyMaterial

DescribeKey

DescribeKeys

DisableKey

DisableKeyRotation

DisableKeys

EnableKey

EnableKeyRotation

EnableKeys

Encrypt

GenerateDataKey

GenerateRandom

GetKeyRotationStatus

GetParametersForImport

GetServiceStatus

ImportKeyMaterial

ListKeyDetail

ListKeys

ReEncrypt

ScheduleKeyDeletion

UpdateAlias

UpdateKeyDescription