基線事件檢測任務運行狀態查詢
更新時間 2025-05-08 16:02:05
最近更新時間: 2025-05-08 16:02:05
分享文章
接口功能介紹
查詢檢測任務運行狀態。
接口約束
此功能為收費功能。確認已經購買系統配額，并且開啟基線掃描配置。如果沒有購買配額，可按照頁面提示進行購買。如果沒有開啟防護，請在服務器列表頁開啟機器防護
URI
POST /v1/sca/event/isrun/check
路徑參數
無
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 資源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 請求地址類型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| scaRuleId | 是 | Integer | 基線策略Id | 1 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | String | 狀態碼 200-成功 | ||
| error | String | 返回碼 CTCSSCN_000000：成功 CTCSSCN_000001：失敗 CTCSSCN_000003：用戶未簽署協議，安全衛士系統無法正常使用 CTCSSCN_000004：鑒權錯誤 CTCSSCN_000005：用戶沒有付費版配額，功能不可用 |
CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回對象 | RefreshTaskMongoDto |
表 RefreshTaskMongoDto
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| taskId | String | 任務id | 1c6485192b4478c96a142547 | |
| policy | String | 基線策略ID | 20 | |
| agentGuid | Array of Strings | agentGuid | [ "564DE7A9-7BD2-E605-3115-BD5863BF9F1C", "72603142-5C6F-01B9-1843-52AAC2375539" ] |
|
| flag | Boolean | 檢測執行是否結束 true-結束 false-未結束 | true | |
| created | String | 最后檢測時間 | 2022-05-26 16:55:50 | |
| taskStatus | Integer | 檢測狀態 0：未執行 1：執行中 2：執行完畢 3：取消執行 4：超時取消執行 5：失敗 |
1 | |
| taskStatusDesc | String | 檢測狀態說明 | 執行中 |
枚舉參數
無
請求示例
請求url
無
請求頭header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
請求體body
{"scaRuleId":"230"}
響應示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查詢成功!","returnObj":{"taskStatus": 2,"taskStatusDesc": "執行完畢","executionPolicy": "immediate_scan","taskId": "202205051443109e471e00e1c6485192b4478c96a142547","type": "sca","policy": 7,"osType": "Linux","execution": null,"agentGuid": ["564DE7A9-7BD2-E605-3115-BD5863BF9F1C","72603142-5C6F-01B9-1843-52AAC2375539","9AED95AE-D9CB-40A1-A8CD-895A03C1595F","B663F8A4-AEAB-4F2C-843F-DE5462AACFFC","F5283205-CB2C-45E6-8629-9D5DB63D3AC3"],"created": "2022-05-05T06:43:10.132+00:00","adminId": null,"ctyunUserId": "9e471e00e1c6485192b4478c96a14254","zoneId": 0,"flag": true,"data": null,"time": 180}}
狀態碼
請參考
錯誤碼
請參考
