correlation.create

Description

object correlation.create(object/array correlations)

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

Cette méthode est disponible uniquement pour le type d’utilisateur Super admin. Les permissions d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir User roles pour plus d’informations.

Paramètres

(object/array) Corrélations à créer.

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

Paramètre Type Description
operations array Opérations de corrélation à créer pour la corrélation.

Comportement du paramètre :
- obligatoire
filter object Objet filtre de corrélation pour la corrélation.

Comportement du paramètre :
- obligatoire

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 une nouvelle corrélation de tags d’événement

Créez une corrélation en utilisant 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
            }
        ]
    },
    "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 ID 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
            }
        ]
    },
    "id": 1
}

Réponse :

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

Voir également

Source

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