Sidebar

correlatie.creëren

Beschrijving

objectcorrelatie.create(object/array-correlaties)

Deze methode maakt het mogelijk om nieuwe correlaties te creëren.

Deze methode is alleen beschikbaar voor het gebruikerstype Super admin. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.

Parameters

(object/array) Te maken correlaties.

Naast de standaardcorrelatie eigenschappen, accepteert de methode het volgende: parameters.

|Parameter|Type|Beschrijving| |---------|--------------------------------------- ------------|-----------| |operations
(vereist)|array|Correlatie bewerkingen die moet worden gemaakt voor de correlatie.| |filter
(vereist)|object|Correlation filter object voor de correlatie.|

Retourwaarden

(object) Retourneert een object met de ID's van de gemaakte correlaties onder de eigenschap 'correlationids'. De volgorde van de geretourneerde ID's komen overeen met de volgorde van de doorgegeven correlaties.

Voorbeelden

Create a new event tag correlation

Maak een correlatie met behulp van evaluatiemethode 'EN/OF' met één voorwaarde en één operatie. Standaard is de correlatie ingeschakeld.

Verzoek:

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

Antwoord:

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

Een aangepast expressiefilter gebruiken

Maak een correlatie die een aangepaste filtervoorwaarde gebruikt. De formule-ID's "A" of "B" zijn willekeurig gekozen. Voorwaarde type zal wees "Hostgroep" met operator "<>". Verzoek:

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

Antwoord:

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

Zie ook

Bron

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