correlation.create

Опис

object correlation.create(object/array correlations)

Цей метод дозволяє створювати нові кореляції.

Цей метод доступний лише для користувачів типу Суперадміністратор. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(object/array) Кореляції для створення.

Окрім стандартних властивостей кореляції, метод приймає такі параметри.

Параметр Тип Опис
operations
(обов’язково)
масив Кореляційні операції для створення кореляції.
filter
(обов’язково)
об’єкт Об’єкт кореляції фільтр для кореляції.

Повернуті значення

(object) Повертає об’єкт, що містить ідентифікатори створених кореляцій у властивості correlationids. Порядок повернених ідентифікаторів відповідає порядку переданих кореляцій.

Приклади

Створіть нову кореляцію тегів події

Створіть кореляцію за допомогою методу оцінки «І/АБО» з однією умовою та однією операцією. За замовчуванням кореляція буде ввімкнена.

Запит:

{
           "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" вибрано довільно. Тип умови буде «Група хостів» з оператором «<>».

Запит:

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