解密数据密钥 功能介绍功能介绍

● 功能介绍：解密数据密钥，用指定的主密钥解密数据密钥。

调试

您可以在API Explorer中调试该接口。

URI

POST /v1.0/{project_id}/kms/decrypt-datakey

表4-204 路径参数

参数 是否必选 参数类型 描述

project_id 是 String 项目ID

请求参数

表4-205 请求 Header 参数

参数 是否必选 参数类型 描述

X-Auth-Token 是 String 用户Token。 通过调用IAM服务 获取用户Token接口获取（响应 消息头中X-Subject-Token的 值）。

表4-206 请求 Body 参数

参数 是否必选 参数类型 描述

key_id 是 String 密钥ID，36字节，满足正则匹

配“^[0-9a-z]{8}-z]{4}-[0-9a- [0-9a-z]{4}-[0-9a-z]{4}-[0-9a-z]{12}$”。 例如：0d0466b0-

e727-4d9c-b35d-f84bb474a37f。

cipher_text 是 String DEK密文及元数据的16进制字符 串。取值为加密数据密钥结果中 的cipher_text的值。

datakey_ciphe

r_length 是 String 密钥字节长度，取值范围为

1~1024。 密钥字节长度，取值 为“64”。

sequence 否 String 请求消息序列号，36字节序列 号。 例如：

data_key String DEK明文的16进制字符串。

datakey_lengt

h String DEK明文字节长度。

datakey_dgst String DEK明文的SHA256值对应的16进制字符串。

状态码： 400

表4-208 响应 Body 参数

参数 参数类型 描述

error Object 错误信息返回体。

表4-209 ErrorDetail

参数 参数类型 描述

error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息

状态码： 401

表4-210 响应 Body 参数

参数 参数类型 描述

error Object 错误信息返回体。

表4-211 ErrorDetail

参数 参数类型 描述

error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息

状态码： 403

表4-212 响应 Body 参数

参数 参数类型 描述

error Object 错误信息返回体。

表4-213 ErrorDetail

参数 参数类型 描述

error_msg String 错误请求返回的错误信息

状态码： 404

表4-214 响应 Body 参数

参数 参数类型 描述

error Object 错误信息返回体。

表4-215 ErrorDetail

参数 参数类型 描述

error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息

状态码： 500

表4-216 响应 Body 参数

参数 参数类型 描述

error Object 错误信息返回体。

表4-217 ErrorDetail

参数 参数类型 描述

error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息

状态码： 502

表4-218 响应 Body 参数

参数 参数类型 描述

error Object 错误信息返回体。

表4-219 ErrorDetail

参数 参数类型 描述

error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息

状态码： 504

表4-220 响应 Body 参数

参数 参数类型 描述

error Object 错误信息返回体。

表4-221 ErrorDetail

参数 参数类型 描述

error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息

请求示例

{ "key_id" : "0d0466b0-e727-4d9c-b35d-f84bb474a37f",

"cipher_text" : "020098005273E14E6E8E95F5463BECDC27E80AFxxxxxxxxxx...", "datakey_cipher_length" : "64"

}

响应示例

状态码： 200 请求已成功

{ "data_key" : "000000e724d9cb35df84bb474a37fXXX...", "datakey_length" : "64",

"datakey_dgst" : "F5A5FD42D16A20302798EF6ED3099XXX..."

}

状态码

状态码 描述

状态码 描述

401 被请求的页面需要用户名和密码

403 认证失败

404 资源不存在，资源未找到 500 服务内部错误

502 请求未完成。服务器从上游服务器收到一个无效的响应

504 网关超时

错误码

请参见错误码。