請求取得具有 Endpoint Agent 元件的主機清單

若要建立具有 Endpoint Agent 元件的主機的資訊請求，請使用 GET HTTP 方法。

命令語法

GET "<Central Node 伺服器的 URL> :<連接埠，預設為 443>/kata/response_api/v1/<external_system_id> /sensors"

如果請求處理成功，則會顯示具有 Endpoint Agent 元件的主機清單。

您可以建立主機資訊的請求，並按主機的 IP 位址、名稱或 ID 進行篩選。您可以指定一個、多個或所有這些篩選器。

指定主機名稱時，請牢記篩選器區分大小寫。

GET "<Central Node 伺服器的 URL>:<連接埠，預設為 443>/kata/response_api/v1/<external_system_id>/sensors?ip=<主機的 IP 位址>&host=<主機名稱>&sensor_id=<sensor_id >"

如果成功處理要求，將顯示有關具有 Endpoint Agent 元件的選定主機的資訊。

設定

參數	類型	敘述
external_system_id	UUID	用於 Kaspersky Anti Targeted Attack Platform 授權的外部系統的唯一 ID。
sensor_id	UUID	具有 Endpoint Agent 元件的主機的唯一 ID。
ip	string	具有 Endpoint Agent 元件的主機的 IP 位址。
host	string	具有 Endpoint Agent 元件的主機的名稱。

輸入帶有參數的命令的範例

GET "https://10.10.0.22:443/kata/response_api/v1/15301050-0490-4A41-81EA-B0391CF21EF3/sensors"

GET "https://10.10.0.22:443/kata/response_api/v1/15301050-0490-4A41-81EA-B0391CF21EF3/sensors?ip=10.16.40.243&host=host4&sensor_id=DF64838B-B518-414B-B769-2B8BE341A2F0"

Response

HTTP 代碼：200

格式：JSON

type Response Sensors

type Server struct {

Version string `json:"version"`

},

type Sensors struct {

SensorID UUID `json:"sensorId"`

HostIP string `json:"hostIp"`

LastAccessTimestamp `json:"lastAccessTimestamp"`

Version string `json:"version"`

SelfDefenseState boolean `json:"selfDefenseState"`

LicenseStatus string `json:"licenseStatus"`

OSFamily string `json:"osFamily"`

OSName string `json:"osName"`

Capabilities array `json:"capabilities"`

}

返回值

返回碼	敘述
400	需要授權。
401	參數不正確。
500, 502, 503, 504	未知伺服器錯誤。稍後重複該請求。

頁面頂部