Documentation

Table of Contents

correlation.create

correlation.create

Описание

object correlation.update(object/array correlations)

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

Этот метод доступен только для пользователя с ролью Super admin. Права на вызов метода могут быть отозваны в настройках роли пользователя. Смотрите User roles для получения дополнительной информации.

Параметры

(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.