Запуск выбранного активного действия для экземпляра интеграции
Запрос
Тип | Метод |
---|---|
POST |
/integration_actions/{action_id}/exec |
Описание: При выполнении запроса будет выполнено активное действие в экземпляре интеграции.
Path параметры запроса:
Параметр | Тип данных | Обязательность | Описание |
---|---|---|---|
action_id | string |
Required | Идентификатор действия |
Пример запроса
POST
Development server
https://development.gigantic-server.com/v1/integration_actions/{action_id}/exec
Staging server
https://staging.gigantic-server.com/v1/integration_actions/{action_id}/exec
Тело запроса:
Параметр | Тип данных | Обязательность | Описание |
---|---|---|---|
agent_id | string |
Required | Идентификатор агента сторонней системы. В данном случае, агента системы RT Protect Endpoint Detection and Response (далее RT Protect EDR) |
params | Array<object> |
Required | Список параметров для запуска скрипта |
params{parameter_name} | string |
Required | Имя передаваемого параметра |
params{parameter_value} | string |
Required | Значение передаваемого параметра |
Пример тела запроса
{
"agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
"params": [
{
"parameter_name": "string",
"parameter_value": "string"
}
]
}
Успешный ответ
Статус код: 200
– запрос успешно обработан.
Формат: Результат запуска активного действия в формате string
.
Другие возможные ответы
Код | Ответ | Описание |
---|---|---|
400 |
Bad Request |
Неверный тип параметра запроса, либо отсутствует обязательный параметр |
500 |
Internal Server Error |
Другие ошибки при удалении объектов |
Примечание: Текст ошибки не фиксированный, может изменяться в зависимости от фактического ответа получателя запроса.
Пример ответа
Код 400
{ "error": "Bad Request", "error_code": 400 }
Код 500
{ "error": "Internal Server Error", "error_code": 500 }