請求掃描結果

若要建立接收掃描結果的請求，請使用 HTTP GET方法。例如，您可以使用 CURL 命令列實用程式建立請求。

您可以使用附加開關來設定執行 cURL 指令的參數（請參閱下表）。

有關 CURL 命令開關的更多資訊，請參閱 cURL 檔案。

命令語法

curl --cert <TLS 憑證檔案路徑> --key <私密金鑰檔案路徑> -X GET "<Central Node 元件伺服器的 URL>:<連接埠，預設443>/kata/scanner/v1/sensors/<sensorId>/scans/state?sensorInstanceId=<sensorInstanceId>&state=<您想要在掃描結果中顯示的一個或多個掃描狀態>"

如果請求傳送成功，則會顯示掃描物件的請求清單以及掃描這些物件的結果。掃描結果將會依照您在state參數中指定的狀態進行篩選。例如，如果您在掃描結果請求中指定 State=processing,detect，則應用程式將只顯示正在處理或應用程式在其中偵測到威脅的物件掃描要求。

設定

參數	類型	敘述
`sensorId`	string	用於 Kaspersky Anti Targeted Attack Platform 授權的外部系統的唯一 ID。
`狀態`	陣列（字串元素類型）	物件掃描狀態。定義此參數後，將依狀態篩選掃描結果。指示一種或多種狀態，以逗號分隔。可以使用以下參數值： `detect` `not detected` `processing` `timeout` `error`
`sensorInstanceId`	string	外部系統實例的唯一 ID。組合成一個叢集的伺服器也被視為外部系統的實例。此參數是可選的。

參數

類型

敘述

sensorId

string

用於 Kaspersky Anti Targeted Attack Platform 授權的外部系統的唯一 ID。

狀態

陣列（字串元素類型）

物件掃描狀態。定義此參數後，將依狀態篩選掃描結果。

指示一種或多種狀態，以逗號分隔。

可以使用以下參數值：

detect
not detected
processing
timeout
error

sensorInstanceId

string

外部系統實例的唯一 ID。組合成一個叢集的伺服器也被視為外部系統的實例。此參數是可選的。

Response

HTTP 代碼：200

格式：JSON

type Response []Scans

type Scans struct {

ScanID integer `json:"scanId"`

State array `json:"state"`

}

返回值

返回碼	敘述
`204`	沒有內容。
`404`	未找到指定 ID 的掃描結果。
`500`	內部伺服器錯誤。稍後重複該請求。

如果要在掃描結果中顯示所有物件掃描狀態時輸入帶有開關的命令的範例

curl --cert /root/cert.pem --key /root/server.key -X GET "https://10.10.10.1:443/kata/scanner/v1/sensors/dd11a1ee-a00b-111c-b11a-11001b1f1111/scans/state?sensorInstanceId=instance1&state=detect,not%20detected,processing,error,timeout"

頁面頂部