Documentation

Table of Contents

correlation.create

correlation.create

Описание

object correlation.update(объект/массив correlations)

Этот метод позволяет создавать новые корреляции.

Этот метод доступен только пользователю с типом доступа Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(object/array) Создаваемые корреляции.

В дополнение к стандартным свойствам корреляции, этот метод принимает следующие параметры.

Параметр	Тип	Описание
operations (обязательный)	array	Корреляция операций для создания корреляции.
filter (обязательный)	object	Объект фильтра корреляции для корреляции.

Возвращаемые значения

(object) Возвращает объект, который содержит ID созданных корреляций под свойством correlationids. Порядок возвращаемых ID совпадает с порядком переданных корреляций.

Примеры

Создание корреляции на тег нового события

Создание корреляции, которое использует метод вычисления И/ИЛИ (AND/OR), с одним условием и одной операцией. По умолчанию корреляция будет активирована.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "correlation.create",
           "params": {
               "name": "new event tag correlation",
               "filter": {
                   "evaltype": 0,
                   "conditions": [
                       {
                           "type": 1,
                           "tag": "ok"
                       }
                   ]
               },
               "operations": [
                   {
                       "type": 0
                   }
               ]
           },
           "auth": "343baad4f88b4106b9b5961e77437688",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "correlationids": [
                   "1"
               ]
           },
           "id": 1
       }

Использование пользовательского фильтра выражений

Создайте корреляцию, которая будет использовать пользовательское условие фильтра. Идентификаторы формулы «A» или «B» выбраны произвольно. Тип условия будет "Host group" с оператором "<>".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "correlation.create",
           "params": {
               "name": "new host group correlation",
               "description": "a custom description",
               "status": 0,
               "filter": {
                   "evaltype": 3,
                   "formula": "A or B",
                   "conditions": [
                       {
                           "type": 2,
                           "operator": 1,
                           "formulaid": "A"
                       },
                       {
                           "type": 2,
                           "operator": 1,
                           "formulaid": "B"
                       }
                   ]
               },
               "operations": [
                   {
                       "type": 1
                   }
               ]
           },
           "auth": "343baad4f88b4106b9b5961e77437688",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "correlationids": [
                   "2"
               ]
           },
           "id": 1
       }

Смотрите также

Источник

CCorrelation::create() в ui/include/classes/api/services/CCorrelation.php.