調用Decrypt接口將密文解密為明文。
使用說明
當您調用Encrypt或GenerateDataKey接口生成密文后,可以通過Decrypt解密。
關于密鑰規格以及加密模式的詳細信息,請參見密鑰管理類型和密鑰規格。
注意事項
所有請求參數使用Protocol Buffers編碼后(即Request Body),內容長度不能超過3 MB,超過3 MB后服務端會拒絕處理并返回HTTP 413狀態碼。建議單次使用對稱密鑰加解密的數據不超過6 KB,單次使用非對稱密鑰加解密的數據不超過1 KB,超過后請使用信封加密方案。詳細信息,請參見使用KMS密鑰進行信封加密。
單次加解密的數據量越大,網絡傳輸失敗可能性越大,網絡傳輸所需時間越長,KMS實例對數據進行加解密所需時間也越長。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
KeyId | string | 是 | key-hzz62f1cb66fa42qo**** | 密鑰的全局唯一標識符。該參數也可以被指定為密鑰別名。 |
Algorithm | string | 否 | AES_GCM | 解密算法。 重要 必須與加密時使用的算法相同。 |
Iv | bytes | 否 | 二進制數據 | 初始向量。 僅當解密算法(Algorithm參數)為AES_GCM、AES_CBC或或SM4_GCM時需要提供本參數。
重要 必須與加密時使用的初始向量相同。 |
CiphertextBlob | bytes | 是 | 二進制數據 | 待解密的密文。 說明 當采用ECIES算法時,密文格式遵循SEC 1: Elliptic Curve Cryptography, Version 2.0標準。 |
Aad | bytes | 否 | 二進制數據 | 認證數據。長度不超過8192字節。 僅當解密算法(Algorithm)是AES_GCM或SM4_GCM,且加密時指定了認證數據(Aad)時,需要提供本參數。 重要 必須與加密時使用的認證數據相同。 |
PaddingMode | string | 否 | PKCS7_PADDING | 填充模式。 僅當加密算法為AES_CBC或AES_ECB時,需要提供本參數。 重要 必須與加密時使用的填充模式相同。 取值:
|
響應數據
名稱 | 類型 | 示例值 | 描述 |
Plaintext | bytes | 二進制數據 | 解密后的明文。 |
KeyId | string | key-hzz62f1cb66fa42qo**** | 密鑰的全局唯一標識符。如果請求中的KeyId參數使用的是密鑰別名,在響應中會返回別名對應的密鑰的全局唯一標識符。 |
Algorithm | string | AES_GCM | 解密算法。 |
PaddingMode | string | PKCS7_PADDING | 填充模式。 |
RequestId | string | 475f1620-b9d3-4d35-b5c6-3fbdd941423d | 本次調用請求的ID,是由阿里云為該請求生成的唯一標識符,可用于排查和定位問題。 |
錯誤碼
HTTP狀態碼 | 錯誤碼 | 錯誤消息 | 描述 |
500 | InternalFailure | Internal Failure. | 可能原因為:
如果已排除上述原因,請您通過智能在線聯系技術支持人員。 |
訪問公共錯誤碼查看更多錯誤碼。