請求掃描物件

若要建立掃描物件的請求,請使用 HTTP POST方法。例如,您可以使用 CURL 命令列實用程式建立請求。

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

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

命令語法

curl --cert<TLS 憑證檔案路徑> --key <私鑰檔案路徑> -X POST "<Central Node 元件伺服器的 URL> :<連接埠,預設為 443>/kata/scanner /v1/sensors/<sensorId> /scans?sensorInstanceId=<sensorInstanceId> " -F "content=<要掃描的檔案的路徑>" -F scanId=<掃描請求 ID> -F "objectType=file"

如果請求成功處理,將顯示OK狀態。

設定

參數

類型

敘述

sensorId

UUID

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

content

file

掃描物件的內容。

scanId

string

掃描請求的唯一 ID。它必須在外部系統中產生。它不能包含空格或特殊字元。請勿使用檔案名稱作為掃描請求 ID。

如果未定義此參數,則無法檢視掃描結果。

objectType

string

掃描物件的類型。

參數的可能值:檔案

sensorInstanceId

string

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

返回值

返回碼

敘述

200

掃描成功完成。

401

需要授權。

429

超過的請求數。稍後重複該請求。

500

內部伺服器錯誤。稍後重複該請求。

輸入具有開關的命令的範例

curl --cert /root/cert.pem --key /root/server.key -X POST "https://10.10.10.1:443/kata/scanner/v1/sensors/dd11a1ee-a00b-111c-b11a-11001b1f1111/scans?sensorInstanceId=instance1" -F "content=@/tmp/test" -F scanId=1 -F "objectType=file"

頁面頂部