列出主密鑰的所有密鑰版本
更新時間 2024-08-15 17:02:18
最近更新時間: 2024-08-15 17:02:18
分享文章
接口功能介紹
查詢主密鑰的所有版本
接口約束
請保證賬戶余額大于0
URI
POST /v1/versionControl/listKeyVersions
路徑參數
無
Query參數
無
請求參數
請求頭header參數
請參見請求消息頭
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| cmkUuid | 是 | String | 密鑰唯一標識id | 474e569e-8814-474a-948b-dbcf6d853eff | |
| pageNumber | 是 | String | 當前頁數 | 1 | |
| pageSize | 是 | String | 每頁展示的版本數量 | 10 |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | String | 返回碼,取值范圍: 200:成功 400:參數缺失或錯誤 401:用戶驗證錯誤 404:操作目標不可用 500:系統內部錯誤 |
200 | |
| errorCode | 是 | String | 錯誤碼 | KMS.0514 | |
| msg | 是 | String | 調用結果信息 | 獲取密鑰版本信息成功 | |
| data | 是 | Object | 接口返回結果 | returnObj |
表 returnObj
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| pageNumber | 是 | String | 當前頁數 | 1 | |
| pageSize | 是 | String | 每頁數據數量 | 10 | |
| content | 是 | List | 密鑰版本id | contentList | |
| totalCount | 是 | int | 數據總數 | 10 |
表 contentList
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| cmkUuid | 是 | String | 密鑰唯一標識id | 474e569e-8814-474a-948b-dbcf6d853eff | |
| primaryKeyVersion | 是 | String | 密鑰版本id | 474e569e-8814-474a-948b-dbcf6d853eff | |
| updatedAt | 是 | String | 版本創建時間 | 2021-05-17 19:32:58 |
請求示例
請求頭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": "70b4d747-abc2-471b-abea-622daf112d41",
"pageNumber": "1",
"pageSize": "10",
}
響應示例
{
"code": "200",
"errorCode": null,
"msg": "獲取密鑰版本信息成功",
"data": {
"content": [
{
"cmkUuid": "28d7ccf6-5524-49f5-a146-c7e93c437f4e",
"primaryKeyVersion": "48f4ba45-0192-454a-8d43-eb788f131641",
"updatedAt": "2021-05-17 19:32:58",
}
],
"pageSize ": "1",
"pageNumber":"10",
"totalCount":"1"
}
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 表示請求成功。 |
| 400 | 表示參數缺失或錯誤。 |
| 401 | 表示用戶驗證錯誤。 |
| 404 | 表示操作目標不可用。 |
| 500 | 表示系統內部錯誤。 |
錯誤碼
請參考 錯誤碼說明。