接口功能介绍
导入密钥材料接口
接口约束
请保证账户余额大于0
URI
POST /v1/importKey/importKeyMaterial
路径参数
无
Query参数
无
请求参数
请求头header参数
详见请求消息头
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| cmkUuid | 是 | String | 密钥唯一标识id | 474e569e-8814-474a-948b-dbcf6d853eff | |
| encryptedKeyMaterial | 是 | String | 通过公钥加密并用base64编码后的密钥材料，此公钥为通过“获取导入主密钥材料参数”接口返回的用于加密密钥材料的公钥 | i1XWzs02bWYyImctYBEidIyTmvw8796S8p6iUw KGfnpyx8cJikBT1jE9Cd6ptwqKA3Y657NEilmKlRp== |
|
| importToken | 是 | String | 导入令牌，通过“获取导入主密钥材料参数”接口返回 | MmNkZDk4YjEtNjBhMi00MWFhLWI3ZDY tMmM4MGQyOWNkNDYyNzRm**asdasd== |
|
| keyMaterialExpireUnix | 否 | String | 密钥材料过期时间，取值范围： 0：表示无过期时间 具体时间：有过期时间则填入具体时间，格式：yyyy-MM-dd HH:mm:ss |
0 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | String | 返回码，取值范围： 200：成功 400：参数缺失或错误 401：用户验证错误 404：操作目标不可用 500：系统内部错误 |
200 | |
| errorCode | 是 | String | 错误码 | KMS.0514 | |
| msg | 是 | String | 调用结果信息 | 密钥导入成功 | |
| data | 是 | Object | 接口返回结果 | null |
请求示例
请求头header
{
"Content-Type": "application/json",
"requestDate": "20221101T154654Z",
"ctyun-eop-request-id": "89bf1559-a96e-4bc9-98fc-394d169a42e4",
"Eop-Authorization":"91ef73a6329545c294be1d5c763bdf7e Headers=ctyun-eop-request-id;eop-date Signature=2mc3zggaqLEGTSVy2H8lWsFEm+BNJf0CrcomDSOxPfc=",
"regionId":"60a39fca876e11ea91cf0242ac110002"
}
请求体body
{
"cmkUuid":"474e569e-8814-474a-948b-dbcf6d853eff",
"encryptedKeyMaterial":"bCPZx7I6v6KXsqEpr2OXKxuj2CCRtKdwp75Bw+BGncYqBdfjFBYRtOE6HRlT0oeiRDWzwnw9OA54OL36smDJrq4Lo9x0CyYDiuKnRkcKtMtlzW0din7Pd7IlZWWRdVueiw2qpzl7PkUWQGTdsdbzpfJJQ+qj/cRIrk/E83UGyeyytSpgnb+lu0xEYcPajRyWNsbi98N3pqqQzHXNNHO2NJqHlnQgglqTiBEjkGeKFhfKmTc3vjulIdVa3EaVIN6lwWfgx",
"importToken":"keyMaterialExpireUnix"，
"keyMaterialExpireUnix":"0"
}
响应示例
{
"code": "200",
"errorCode": null,
"msg": "密钥导入成功",
"data":null
}
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 表示请求成功。 |
| 400 | 表示参数缺失或错误。 |
| 401 | 表示用户验证错误。 |
| 404 | 表示操作目标不可用。 |
| 500 | 表示系统内部错误。 |
错误码
请参考 错误码说明。
