请求获取有关任务的信息

技术支持

企业产品

Kaspersky Anti Targeted Attack (KATA) Platform

通过 API 与外部系统交互

用于管理威胁响应操作的 API

管理应用程序运行任务

请求获取有关任务的信息

2024年6月26日

ID 227590

另存为 PDF

要创建获取有关任务的信息的请求，请使用 HTTP GET 方法。

命令语法

GET "<中央节点服务器的 URL>:<端口，默认为 443>/kata/response_api/v1/<external_system_id>/tasks/<task_id>?settings=<true or false>"

如果请求处理成功，则会显示有关任务的设置、创建时间和完成状态的信息。

设置

设置	类型	描述
`external_system_id`	`UUID`	用于 Kaspersky Anti Targeted Attack Platform 授权的外部系统的唯一 ID。
`sensor_id`	`UUID`	具有端点代理组件的主机的唯一 ID。
`task_id`	`UUID`	任务的唯一 ID。
`settings`	`boolean`	可能值： true。如果输入此值，将显示有关任务的设置、创建时间和完成状态的信息。 false。如果输入此值，将显示有关任务的创建时间和完成状态的信息。

使用开关输入命令的示例

GET https://10.10.0.22:443/kata/response_api/v1/15301050-0490-4A41-81EA-B0391CF21EF3/tasks/2EEB4CBC-10C6-4DC4-BE0A-72A75CDB0BE8?settings=<true or false>

Response

HTTP 代码：200

格式：JSON

type Response struct {

State `json:"state"`

LastStartDateTime `json:"latestStartDateTime"`

type Task struct {

type Schedule struct {

StartNow boolean `json:"startNow"`

ExecCommand string `json:"execCommand"`

}

返回值

返回码	描述
`400`	参数不正确。
`401`	需要授权。
`409`	指定 ID 的任务已经存在。
`500, 502, 503, 504`	内部服务器错误。稍后重复该请求。

Kaspersky Professional Services

Implementation services. Health check and security system configuration. Contact us if you need expert help.

Kaspersky Premium Support (MSA): High‑priority incident processing

Telephone and web ticket support. Fast response, monitoring and health check. Submit a request and activate the contract (MSA).

Did you find this article helpful?

What can we do better?

Thank you for your feedback! You're helping us improve.