请求获取具有 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
|
返回值
返回码 | 描述 |
---|---|
400 | 需要授权。 |
401 | 参数不正确。 |
500, 502, 503, 504 | 内部服务器错误。稍后重复该请求。 |