Getting information about a task

To create a request for getting information about a task, the HTTP GET method is used.

Command syntax

GET "<URL of the Central Node server>:<port, 443 by default>/kata/response_api/v1/<external_system_id>/tasks/<task_id>?settings=<true or false>"

If the request is processed successfully, information is displayed about settings, creation time, and completion status of the task.

Settings

Settings	Type	Description
`external_system_id`	`UUID`	Unique ID of the external system used for authorization in Kaspersky Anti Targeted Attack Platform.
`sensor_id`	`UUID`	Unique Kaspersky Endpoint Agent host identifier.
`task_id`	`UUID`	Unique ID of the task.
`settings`	`boolean`	Possible values: true. If you enter this value, information is displayed about settings, creation time, and completion status of the task. false. If you enter this value, information about creation time and completion status of the task is displayed.

Example of entering a command with switches

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>

Returned value

Return code	Description
`200`	Operation completed successfully.
`400`	Incorrect parameters.
`401`	Authorization required.
`409`	The task with the specified ID was already exists.
`500, 502, 503, 504`	Internal server error. Repeat the request later.

Page top