请求获取具有 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 组件的选定主机的信息。

Settings

参数

类型

描述

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-2B8BE341A 2F0"

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

内部服务器错误。稍后重复该请求。

页面顶部