Documentation
Table of Contents
correlation.create
Description
objet correlation.create(objet/tableau corr¨¦lations)
Cette m¨¦thode permet de cr¨¦er de nouvelles corr¨¦lations.
Cette m¨¦thode n'est disponible que pour le type utilisateur Super admin. Les autorisations d'appeler la m¨¦thode peuvent ¨ºtre r¨¦voqu¨¦es dans les param¨¨tres de r?le d'utilisateur. Voir R?les utilisateur pour plus d'informations.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ
(object/array) °ä´Ç°ù°ù¨¦±ô²¹³Ù¾±´Ç²Ôs ¨¤ cr¨¦er
En plus des propri¨¦t¨¦s de corr¨¦lation standard, la m¨¦thode accepte les param¨¨tres suivants :
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Type | Description |
|---|---|---|
| operations (obligatoire) |
array | °¿±è¨¦°ù²¹³Ù¾±´Ç²Ô²õ de corr¨¦lation ¨¤ cr¨¦er pour la corr¨¦lation. |
| filter (obligatoire) |
object | Objet de filtre de corr¨¦lation pour la corr¨¦lation. |
Valeurs retourn¨¦es
(object) Renvoie un objet contenant les ID des corr¨¦lations cr¨¦¨¦es sous la propri¨¦t¨¦ correlationids. L'ordre des ID renvoy¨¦s correspond ¨¤ l'ordre des corr¨¦lations transmises.
Exemples
Cr¨¦er un nouveau tag d'¨¦v¨¦nement de corr¨¦lation
Cr¨¦ez une corr¨¦lation ¨¤ l'aide de la m¨¦thode d'¨¦valuation "AND/OR" avec une condition et une op¨¦ration. Par d¨¦faut, la corr¨¦lation sera activ¨¦e.
Requ¨ºte :
{
"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
}R¨¦ponse :
Utiliser une expression de filtre personnalis¨¦
Cr¨¦ez une corr¨¦lation qui utilisera une condition de filtre personnalis¨¦e. Les identifiants de formule "A" ou "B" ont ¨¦t¨¦ choisis arbitrairement. Le type de condition sera "Groupe d'h?tes" avec l'op¨¦rateur "<>".
Requ¨ºte :
{
"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
}R¨¦ponse :
Voir ¨¦galement
Source
CCorrelation::create() dans ui/include/classes/api/services/CCorrelation.php.