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.