Перейти к содержанию

Запуск выбранного активного действия для экземпляра интеграции

Запрос

Тип Метод
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
}