key_info KeyDescripti
4.1.3 导入密钥管理
4.1.3.1 获取密钥导入参数 功能介绍
● 功能介绍:获取导入密钥的必要参数,包括密钥导入令牌和密钥加密公钥。
● 说明:返回的公钥类型默认为RSA_2048。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1.0/{project_id}/kms/get-parameters-for-import
表4-222 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID
请求参数
表4-223 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。 通过调用IAM服务 获取用户Token接口获取(响应 消息头中X-Subject-Token的 值)。
表4-224 请求 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。
wrapping_alg
orithm 是 String 密钥材料加密算法,枚举如下:
● RSAES_OAEP_SHA_256
● SM2_ENCRYPT,部分局点不 支持该导入类型
sequence 否 String 请求消息序列号,36字节序列 号。 例如:
key_id String 密钥ID。
import_token String 密钥导入令牌。
expiration_tim
e Long 导入参数到期时间,时间戳,即从1970年1月1日
至该时间的总秒数。
状态码: 400
表4-226 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-227 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码: 401
表4-228 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-229 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码: 403
表4-230 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-231 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码
参数 参数类型 描述
error_msg String 错误请求返回的错误信息
状态码: 404
表4-232 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-233 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码: 500
表4-234 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-235 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码: 502
表4-236 响应 Body 参数
参数 参数类型 描述
表4-237 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码: 504
表4-238 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-239 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
请求示例
{ "key_id" : "0d0466b0-e727-4d9c-b35d-f84bb474a37f", "wrapping_algorithm" : "RSAES_OAEP_SHA_256"
}
响应示例
状态码: 200 请求已成功
{ "key_id" : "bb6a3d22-dc93-47ac-b5bd-88df7ad35f1e",
"import_token" : "AACIBjY2ZTQxYjBmLTY3ZWItNDU4Ny04OTIxLWVhZXXX...", "expiration_time" : 1501578672,
"public_key" : "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCXXX..."
}
状态码
状态码 描述
200 请求已成功
400 请求参数有误
状态码 描述
401 被请求的页面需要用户名和密码
403 认证失败
404 资源不存在,资源未找到 500 服务内部错误
502 请求未完成。服务器从上游服务器收到一个无效的响应
504 网关超时
错误码
请参见错误码。