創建用戶主密鑰
更新時間 2025-08-26 11:58:47
最近更新時間: 2025-08-26 11:58:47
分享文章
接口功能介紹
創建用戶主密鑰接口,可以創建多種對稱,非對稱密鑰
接口約束
請保證賬戶余額大于0
URI
POST /v1/cmkManage/createKey
路徑參數
無
Query參數
無
請求參數
請求頭header參數
請參見請求消息頭
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| protectionLevel | 是 | String | 保護等級,取值范圍: 0:硬件 1:軟件 | 0 | |
| keySpec | 是 | String | 支持的加密算法,軟件加密取值范圍: AES_256 RSA_2048 硬件加密取值范圍: AES_256 RSA_2048 Ctyun_SM2 Ctyun_SM4 | AES_256 | |
| keyUsage | 是 | String | 密鑰類型,取值范圍: 1:加密解密 2:簽名驗簽 | 1 | |
| description | 否 | String | 密鑰描述,長度小于8129 | 存儲加密密鑰 | |
| enableAutomaticRotation | 是 | String | 是否開啟輪轉,取值范圍: true:開啟 false:不開啟 | true | |
| rotationInterval | 否 | String | 輪轉周期:時間范圍為7天-730天,只需要傳“數字+d”即可 | 7d | |
| origin | 是 | String | 密鑰來源,取值范圍: 1:KMS 2:外部密鑰 | 1 | |
| aliasName | 否 | String | 密鑰別名 | ECS |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | String | 返回碼,取值范圍: 200:成功 400:參數缺失或錯誤 401:用戶驗證錯誤 404:操作目標不可用 500:系統內部錯誤 | 200 | |
| errorCode | 是 | String | 錯誤碼 | KMS.0514 | |
| msg | 是 | String | 調用結果信息 | 用戶主密鑰創建成功 | |
| data | 是 | Object | 接口返回結果 | returnObj |
表 returnObj
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| deleteDate | 是 | String | 密鑰刪除時間 | Tue Oct 25 15:06:52 CST 2022 | |
| rotationInterval | 是 | String | 輪轉周期,時間范圍為7天-730天,例如7d代表7天 | 7d | |
| nextRotationDate | 是 | String | 下次輪轉時間 | Tue Oct 25 15:06:52 CST 2022 | |
| creationDate | 是 | String | 密鑰創建時間 | Tue Oct 25 15:06:52 CST 2022 | |
| description | 是 | String | 密鑰描述 | 密鑰描述,長度小于8129 | Tue Oct 25 15:06:52 CST 2022 |
| cmkUuid | 是 | String | 密鑰唯一標識id | 474e569e-8814-474a-948b-dbcf6d853eff | |
| keyState | 是 | String | 密鑰狀態 | 1 | |
| keyUsage | 是 | String | 密鑰類型,取值范圍: 1:加密解密 2:簽名驗簽 | 1 | |
| lastRotationDate | 是 | String | 上一次輪轉時間 | Tue Oct 25 15:06:52 CST 2022 | |
| creator | 是 | String | 密鑰所屬用戶id | 562b89493b1a40e1b97ea05e50dd8170 | |
| protectionLevel | 是 | String | 密鑰保護級別,取值范圍: 0:硬件 1:軟件 | 0 | |
| origin | 是 | String | 密鑰來源,取值范圍: 1:KMS 2:外部密鑰 | 1 | |
| automaticRotation | 是 | String | 是否開啟輪轉,取值范圍: 0:未開啟 1:開啟 2:被暫停 | 1 | |
| materialExpireTime | 是 | String | 密鑰材料過期時間 | Tue Oct 25 15:06:52 CST 2022 | |
| keySpec | 是 | String | 密鑰類型 | AES_256 | |
| aliasName | 是 | String | 密鑰別名 | ECS | |
| regionId | 是 | String | 資源池id | fecnjniakfkn2314ndekqldedcsadfg | |
| primaryKeyVersion | 是 | String | 密鑰版本 | f2ffbff9-940a-41a4-ba9a-fe1fd8f22792 |
請求示例
請求頭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
{
"protectionLevel":"1",
"keySpec":"AES_256",
"keyUsage":"1",
"description":"",
"enableAutomaticRotation":"true",
"rotationInterval":"7d",
"origin":1,
"aliasName":"tdesdt_ali1adddddadcccdsasdas"
}
響應示例
{
"code": "200",
"errorCode": null,
"msg": "用戶主密鑰創建成功",
"data": {
"deleteDate": null,
"rotationInterval": null,
"nextRotationDate": null,
"creationDate": "Tue Oct 25 15:06:52 CST 2022",
"description": "",
"cmkUuid": "474e569e-8814-474a-948b-dbcf6d853eff",
"keyState": "1",
"keyUsage": "1",
"lastRotationDate": "Tue Oct 25 15:06:52 CST 2022",
"creator": "1123",
"protectionLevel": "1",
"origin": "1",
"automaticRotation": "1",
"materialExpireTime": "null",
"keySpec": "AES_256",
"aliasName": "tdesdt_ali1adddddadcccdsasdas",
"regionId": "123",
"primaryKeyVersion": "f2ffbff9-940a-41a4-ba9a-fe1fd8f22792"
}
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 表示請求成功。 |
| 400 | 表示參數缺失或錯誤。 |
| 401 | 表示用戶驗證錯誤。 |
| 404 | 表示操作目標不可用。 |
| 500 | 表示系統內部錯誤。 |
錯誤碼
請參考 錯誤碼說明。