创建不含明文数据密钥

POST /v1.0/{project_id}/kms/create-datakey-without-plaintext

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数
参数	是否必选	参数类型	描述
key_id	是	String	密钥ID，36字节，满足正则匹配“^[0-9a-z]{8}-[0-9a-z]{4}-[0-9a-z]{4}-[0-9a-z]{4}-[0-9a-z]{12}$”。例如：0d0466b0-e727-4d9c-b35d-f84bb474a37f。
key_spec	否	String	指定生成的密钥bit位长度。有效值：AES_256、AES_128。 AES_256：表示256比特的对称密钥。 AES_128：表示128比特的对称密钥。说明： datakey_length和key_spec二选一。若datakey_length和key_spec都为空，默认生成256bit的密钥。若datakey_length和key_spec都指定了值，仅datakey_length生效。
datakey_length	否	String	密钥bit位长度。取值为8的倍数，取值范围为8~8192。说明： datakey_length和key_spec二选一。若datakey_length和key_spec都为空，默认生成256bit的密钥。若datakey_length和key_spec都指定了值，仅datakey_length生效。
sequence	否	String	请求消息序列号，36字节序列号。例如：919c82d4-8046-4722-9094-35c3c6524cff

状态码： 200

表4 响应Body参数
参数	参数类型	描述
key_id	String	密钥ID。
cipher_text	String	加密后的密文，使用了Base64编码

状态码： 400

表5 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

表6 ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 401

表7 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

表8 ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 403

表9 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表10** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 404

**表11** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表12** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 500

**表13** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表14** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 502

**表15** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表16** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 504

**表17** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表18** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

创建"512"位长度的明文数据密钥，并使用ID为"0d0466b0-e727-4d9c-b35d-f84bb474a37f"的密钥进行加密，不返回明文密钥。

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

状态码： 200

请求已成功

{
  "key_id" : "0d0466b0-e727-4d9c-b35d-f84bb474a37f",
  "cipher_text" : "020098009EEAFCE122CAA5927D2XXX..."
}