This is a translation of the original English documentation page. Help us make it better.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

correlation.create

Description

object correlation.create(object/array correlations)

Cette méthode permet de créer de nouvelles corrélations.

Paramètres

(object/array) Correlations à créer.

En plus des propriétés de corrélation standard, la méthode accepte les paramètres suivants.

Paramètres Type Description
operations
(requis)
array Opérations de corrélation à créer pour la corrélation.
filter
(requis)
object Objet de filtre de corrélation pour la corrélation.

Valeurs de retour

(object) Retourne un objet contenant les identifiants des corrélations créées sous la variable correlationids. L'ordre des ID renvoyés correspond à l'ordre des corrélations transmises.

Exemples

Créer une nouvelle corrélation d'étiquette d'évènement

Créez une corrélation à l'aide de la méthode d'évaluation ET/OU 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:

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

Utilisation d'un filtre d'expression 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:

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

Voir également

Source

CCorrelation::create() dans frontends/php/include/classes/api/services/CCorrelation.php.