Zabbix Documentation 3.2

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


Sidebar

ru:manual:api:reference:correlation:create

correlation.create

Описание

объект correlation.create(объект/массив корреляции)

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

Параметры

(объект/массив) Создаваемые корреляции.

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

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

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

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

Примеры

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

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

Запрос:

{
    "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
}

Использование фильтрации при помощи пользовательского выражения

Создание корреляции, которая будет использовать пользовательское условие фильтрации. ID “A” и “B” в формуле были выбраны случайно. Тип условия будет “Группа узлов сети” с оператором “<>”.

Запрос:

{
    "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() в frontends/php/include/classes/api/services/CCorrelation.php.