基線事件根據主機查詢基線事件列表
更新時間 2025-05-08 16:02:13
最近更新時間: 2025-05-08 16:02:13
分享文章
接口功能介紹
以主機維度基線事件列表
接口約束
此功能為收費功能。確認已經購買系統配額，并且開啟基線掃描配置。如果沒有購買配額，可按照頁面提示進行購買。如果沒有開啟防護，請在服務器列表頁開啟機器防護
URI
POST /v1/sca/event/host//
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| currentNum | 是 | Integer | 列表當前頁 | 1 | |
| pageSize | 是 | Integer | 列表每頁記錄數 | 10 |
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 資源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 請求地址類型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| agentGuid | 否 | String | 服務器Id | F5283205-CB2C-45E6-8629-9D5DB63D3AC3 | |
| scaName | 否 | String | 基線策略名 | 基本檢測 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | String | 狀態碼 200-成功 | ||
| error | String | 返回碼 CTCSSCN_000000：成功 CTCSSCN_000001：失敗 CTCSSCN_000003：用戶未簽署協議，安全衛士系統無法正常使用 CTCSSCN_000004：鑒權錯誤 CTCSSCN_000005：用戶沒有付費版配額，功能不可用 |
CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回對象 | pageInfo |
表 PageInfo
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| pageNum | Integer | 當前頁 | 1 | |
| pageSize | Integer | 每頁記錄數 | 10 | |
| pages | Integer | 總頁數 | 2 | |
| total | Integer | 總記錄數 | 20 | |
| isFirstPage | Boolean | 是否為首頁 | false | |
| isLastPage | Boolean | 是否為末頁 | false | |
| list | Array of Objects | 基線列表 | list |
表 list
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| name | String | 基線名稱 | 1 | |
| itemTotal | Integer | 基線檢查項 | 20 | |
| failed | Integer | 風險項數量 | 2 | |
| timestamp | String | 最后檢測時間 | 2022-05-26 16:55:50 | |
| scaId | Integer | 基線id | 1 | |
| strategyId | Integer | 基線策略id | 3 | |
| scanId | Integer | 掃描id | 1606786530 | |
| scaStatus | Integer | 掃描狀態 1：通過 2：未通過 3：失敗 |
1 | |
| scaStatusDesc | String | 基線狀態解釋 | 未通過 |
枚舉參數
無
請求示例
請求url
無
請求頭header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
請求體body
{"agentGuid": "F5283205-CB2C-45E6-8629-9D5DB63D3AC3","scaName": "Unix系統基線檢測"}
響應示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查詢成功!","returnObj": {"total": 2,"list": [{"id": "sca_unix_audit.yml","checkId": null,"white": false,"title": null,"result": null,"passingRate": null,"failed": 9,"relationAgent": 0,"osType": null,"scaStatus": 2,"scaStatusDesc": "未通過","total": 0,"itemTotal": 23,"file": "sca_unix_audit.yml","invalid": 13,"passed": 1,"totalChecks": 23,"strategyId": 31,"scanId": 2147483647,"timestamp": "2022-10-14 17:35:25","data": null,"scaId": 7,"name": "System audit for Unix based systems","agent": null,"agentIp": null,"custName": null,"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C"},{"id": "cis_rhel7_linux.yml","checkId": null,"white": false,"title": null,"result": null,"passingRate": null,"failed": 67,"relationAgent": 0,"osType": null,"scaStatus": 2,"scaStatusDesc": "未通過","total": 0,"itemTotal": 64,"file": "cis_rhel7_linux.yml","invalid": 21,"passed": 40,"totalChecks": 64,"strategyId": 30,"scanId": 474022239,"timestamp": "2022-10-14 17:35:27","data": null,"scaId": 8,"name": "CIS Benchmark for Red Hat Enterprise Linux 7","agent": null,"agentIp": null,"custName": null,"agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C"}],"pageNum": 1,"pageSize": 10,"size": 0,"startRow": 0,"endRow": 0,"pages": 1,"prePage": 0,"nextPage": 0,"isFirstPage": false,"isLastPage": false,"hasPreviousPage": false,"hasNextPage": false,"navigatePages": 0,"navigatepageNums": null,"navigateFirstPage": 0,"navigateLastPage": 0}}
狀態碼
請參考
錯誤碼
請參考
