导入密钥
更新时间 2026-03-12 13:58:17
最近更新时间: 2026-03-12 13:58:17
接口功能介绍
导入密钥材料接口
接口约束
请保证账户余额大于0
URI
POST /v1/importKey/importKeyMaterial
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | fecnjniakfkn2314ndekqldedcsadfg |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| cmkUuid | 是 | String | 密钥唯一标识id | 474e569e-8814-474a-948b-dbcf6d853eff | |
| encryptedKeyMaterial | 是 | String | 公钥加密并用base64编码后的密钥材料 | AKMpvvmXb69YK0ejyHkF1FNfV1OYmHDWp5YQ+5OzAe/bvOULVlHPipQkK218aCW5o+O2ssz8Vw/Zp/WLZDkH7iIEZH49Pz1I8PNjQCzHin6SbdWntelcRchprRBiji5sqCsLDaBzyACqIxmZjQMdbbEQSJvq8WAizmpvE3iPMnvcQFXveD+ax5+n3uJXBt8JxjGFrz2x4Ma3+nxxeoOUhUo9r8+46xfBbsCyOHejeGpCccmeDYKcRMKuCzdbeGzTpDyCDwDSqexGrYSxhTdaFgECas8fBHYaMZD2ImmwV6fsYAnmiJKybgs52mVGfr9n96nRhtpp2fVf+qug8vk0NBA== | |
| encryptedPrivateKeyMaterial | 否 | String | 公钥加密并用base64编码后的私钥密钥材料，导入非对称密钥时使用 | ||
| importToken | 是 | String | 导入令牌 | NjVkMzliZGYtZTFlNi00NTk2LTliYzQtNjE0MDZiMzUyZjM1ZDY3OTJlMWUtZGM2OC00Yjk4LThiOWUtMDc5ZmYxMTUzYzRjJlJTQUVTX1BLQ1MxX1YxXzUmWWZTa3dnRi93TDJucThEYTF0Nnp4L2VBWlNQaDBPTnpHNXNEQmNwQUtmYmRPV2E4RGg0NCt0cmZRcWdsQ2FwVlQvcWkxM2xKK1JQcDR3Sm93WVZiSlBPMmRQVzhPSlpPTHhubkNzTkhyVncyVFplTWhvNzBtN1V0cGtNYThGaFlkc2lCM2hDZGdRQ05ycVBOZ2Z3OVJKL29BOHdmMTJOQ3VxNnZBWVFSZndneFJMRzVMdU9QN2k5T1NKWTIvWG9zQkhQMFNXcWhNYm0xU2J3WGxuZTV6QTFjZ0VEVU5HTlowMjlWd0lZem9JQlZxZGRDSHczTW03UkNOdXZpOUJRL3Z3b2Exc3VKbXVYdTA2NEdKVkZqZllYNGZXZVFUWE9RenNHb05TdU44UXFlU3lXS3M5RVZYL2EyMzg1VkJ4OW1rVC95bkk4dlFBRnZneWNYSXJwYzl3PT0 | |
| keyMaterialExpireUnix | 否 | String | 密钥材料过期时间 | 2025-10-24 11:16:12 | |
| encryptedKey | 是 | String | 瞬时密钥密文 | a5zvhGYr15Ib+MhMA8k0Yhh3dbIhjmDgeRdW423+wJoA1WXRyZEw+SQA/Fr0Ib6duB8oBm6BR7AJ02dF+lwy3K3w8gnPVfseDdddMqQg1gl1TGe6UG3/Y60rd+l4RqA5XgvbiPyiFmvr6emfwOWrXdyfW/Bbdn4tINYsQkLJ7ecpktRciO42Ej2dobw2ieFYS8Gta7N7nBDXBUvgU77USfCA |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 返回码 取值范围：200 成功 | 200 | |
| error | String | 错误码 | KMS_0514 | |
| message | String | 调用结果信息 | 导入密钥成功 | |
| returnObj | Object | 接口返回结果 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| requestId | String | 请求id | 1d6d65ac-761d-4276-ad0f-1b94ef2ea29d |
枚举参数
无
请求示例
请求url
无
请求头header
{
"regionId": "200000001852"
}
请求体body
{
"cmkUuid": "2a61b5b4-45ec-49c0-a3a5-0a72c1a68e94",
"encryptedKeyMaterial": "KMpvvmXb69YK0ejyHkF1FNfV1OYmHDWp5YQ+5OzAe/bvOULVlHPipQkK218aCW5o+O2ssz8Vw/Zp/WLZDkH7iIEZH49Pz1I8PNjQCzHin6SbdWntelcRchprRBiji5sqCsLDaBzyACqIxmZjQMdbbEQSJvq8WAizmpvE3iPMnvcQFXveD+ax5+n3uJXBt8JxjGFrz2x4Ma3+nxxeoOUhUo9r8+46xfBbsCyOHejeGpCccmeDYKcRMKuCzdbeGzTpDyCDwDSqexGrYSxhTdaFgECas8fBHYaMZD2ImmwV6fsYAnmiJKybgs52mVGfr9n96nRhtpp2fVf+qug8vk0NBA==",
"importToken": "NjcxNjYyYzEtZTkyOS00YTdlLTk0ODUtNWExMjRhYmQ2ODgyNTRkNjFhMzYtYWMzMi00Mzg5LTgwZTMtNThkNzExMGY4NmU4JlJTQUVTX09BRVBfU0hBXzI1NiZwY0ZyczFnd3g3VDdFeU13Q0ZpeExJQVdvK2F0RisvZWoxZm5tZG1KeHdUd3pNVWpEUjdXSGtCaEw3SDBEK1ZxenBqS3l1NlpDWkFSUkVZVjF5VmVHbDdQcS90V3ltVHEvYUt3c1VuUnkyZXlYeDU4R3F5ajhkS3hRQVdNL1lzNlVTaUVjK2ErQm9kNU45YVpOZ1YrOVJoWm0zTzBiMWVVTU9jaTNvMXhyNHhpL0VqV1ZOOXRORUZmYXk5akpoTDZsQk1iNHc5TkNKdG8zTnUwMUVGNVoyVEpSd0VvclJLRWNzWGdDM0hWcXJXZzQyWWovSjJTMm1yb09XS1liVlJjUFZSU1VHZEdmZEluUWVVTGZ3bWwwRnNqZVhjbkYxT1VYdld4U0QydkRkSEJkdFBwVGJuZStXRDE0ODd3V0NlODhQOFF2dHdEN0JTbU53T01aUU5EYkE9PQ==",
"keyMaterialExpireUnix": "2024-08-10 13:59:58"
}
响应示例
{
"statusCode": "200",
"message": "密钥导入成功",
"returnObj": {
"requestId": "ce0d6476-1912-4f27-b64e-d8e2c399da51"
}
}
状态码
请参考 状态码
错误码
请参考 错误码
