correlation.create

Opis

object correlation.create(object/array correlations)

Metoda ta pozwala na tworzenie nowych korelacji.

Ta metoda jest dostępna tylko dla użytkowników typu Super admin. Uprawnienia do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz Role użytkownika po więcej informacji.

Parametry

(object/array) Korelacje do utworzenia.

Oprócz standardowych właściwości korelacji, metoda akceptuje następujące parametry.

Parametr Typ Opis
operations
(wymagane)
array Operacja korelacji do utworzenia dla korelacji.
filter
(wymagane)
object Obiekt filtra korekacji dla korelacji.

Zwracane wartości

(object) Zwraca obiekt zawierający ID utworzonych korelacji we właściwości correlationids. Kolejność zwracanych ID są zgodne z kolejności przekazanych korelacji.

Przykłady

Utwórz nową korelację tagów zdarzeń

Utwórz korelację przy użyciu metody oceny AND/OR z jednym warunkiem i jedną operację. Domyślnie korelacja zostanie włączona.

Zapytanie:

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

Odpowiedź:

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

Korzystanie z niestandardowego filtra wyrażeń

Utwórz korelację, która będzie używać niestandardowego warunku filtru. Identyfikatory formuł „A” lub „B” zostały wybrane arbitralnie. Typ warunku to „Grupa hostów” z operatorem „<>”.

Zapytanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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