Kaspersky Anti Targeted Attack (KATA) Platform

请求获取具有 Endpoint Agent 组件的主机列表

2024年6月26日

ID 227251

要创建对具有 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

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

Did you find this article helpful?
What can we do better?
Thank you for your feedback! You're helping us improve.
Thank you for your feedback! You're helping us improve.