De volgende objecten zijn direct gerelateerd aan de correlatie
API.
Het correlatieobject heeft de volgende eigenschappen.
|Property|Type|Beschrijving| |--------|---------------------------------------- -----------|-----------| |correlationid|string|(alleen-lezen) ID van de correlatie.| |name
(verplicht)|string|Naam van de correlatie.| |description|string|Beschrijving van de correlatie.| |status|geheel getal|Of de correlatie is ingeschakeld of uitgeschakeld.
Mogelijke waarden zijn:
0 - (standaard) ingeschakeld;
1 - uitgeschakeld.|
Het correlatie bewerkings object definieert een bewerking die uitgevoerd wanneer een correlatie wordt uitgevoerd. Het heeft het volgende: eigenschappen.
|Property|Type|Beschrijving| |--------|---------------------------------------- -----------|-----------| |type
(vereist)|geheel getal|Type bewerking.
Mogelijke waarden:
0 - oude gebeurtenissen sluiten;
1 - nieuwe gebeurtenis sluiten.|
Het correlatie filter object definieert een set voorwaarden die voldaan om de geconfigureerde correlatiebewerkingen uit te voeren. Het heeft de volgende eigenschappen.
|Property|Type|Beschrijving| |--------|---------------------------------------- -----------|-----------| |evaltype
(vereist)|geheel getal|Filterconditie-evaluatiemethode.
Mogelijke waarden:
0 - en/of;
1 - en;
2 - of;
3 - aangepaste uitdrukking.| |conditions
(vereist)|array|Set van filtervoorwaarden om te gebruiken voor het filteren van resultaten.| |eval_formula|string|(alleen-lezen) Gegenereerde expressie die zal worden gebruikt voor het evalueren van filtervoorwaarden. De expressie bevat ID's die verwijzen naar specifieke filtervoorwaarden door middel van de formulaid
. De waarde van eval_formula
is gelijk aan de waarde van formula
voor filters met een aangepaste expressie.| |formula|string|Door de gebruiker gedefinieerde expressie die moet worden gebruikt voor het evalueren van voorwaarden van filters met een aangepaste expressie. De expressie moet ID's bevatten die verwijzen naar specifieke filtervoorwaarden door middel van de formulaid
. De ID's die in de expressie worden gebruikt, moeten exact overeenkomen met de ID's die zijn gedefinieerd in de filtervoorwaarden: geen enkele voorwaarde mag ongebruikt blijven of worden weggelaten.
Vereist voor aangepaste expressie filters.|
Het voorwaarde object van het correlatiefilter definieert een specifieke voorwaarde die moet worden gecontroleerd voordat de correlatiebewerkingen worden uitgevoerd.
|Property|Type|Beschrijving| |--------|---------------------------------------- -----------|-----------| |type
(verplicht)|geheel getal|Type voorwaarde.
Mogelijke waarden:
0 - oude gebeurtenis tag;
1 - nieuwe gebeurtenis tag;
2 - nieuwe gebeurtenis hostgroep;
3 - gebeurtenis tag paar;
4 - oude gebeurtenis tag waarde;
5 - nieuwe gebeurtenis tag waarde.| |tag|string|Event-tag (oud of nieuw). Vereist wanneer type voorwaarde is: 0, 1, 4, 5.| |groupid|string|Hostgroep-ID. Vereist wanneer type voorwaarde is: 2.| |oldtag|string|Oude gebeurtenis tag. Vereist wanneer type voorwaarde is: 3.| |newtag|string|Oude gebeurtenis tag. Vereist wanneer type voorwaarde is: 3.| |value|string|Event tag (oud of nieuw) waarde. Vereist wanneer type conditie is: 4, 5.| |formulaid|string|Willekeurige unieke ID die wordt gebruikt om te verwijzen naar de voorwaarde vanuit een aangepaste expressie. Mag alleen hoofdletters bevatten. De ID moet door de gebruiker worden gedefinieerd bij het wijzigen van filtervoorwaarden, maar zal opnieuw worden gegenereerd wanneer ze daarna worden aangevraagd.| |operator|geheel getal|Conditie-operator.
Vereist wanneer type voorwaarde is: 2, 4, 5.|
Om beter te begrijpen hoe u filters kunt gebruiken met verschillende soorten uitdrukkingen, zie voorbeelden op de correlation.get en correlation.create methode Pagina's.
De volgende operatoren en waarden worden ondersteund voor elke voorwaarde: type.
|Voorwaarde|Voorwaarde naam|Ondersteunde operators|Verwachte waarde| |---------|--------------|-------------------|---- ----------| |2|Hostgroep|=, <>|Hostgroep-ID.| |4|Oude gebeurtenistagwaarde|=, <>, leuk, niet leuk|string| |5|Nieuwe gebeurtenistagwaarde|=, <>, leuk, niet leuk|string|