correlation.update

Description

object correlation.update(object/array correlations)

Cette méthode permet de mettre à jour des corrélations existantes.

Cette méthode est disponible uniquement pour le type d’utilisateur Super admin. Les autorisations d’appeler 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) Propriétés de corrélation à mettre à jour.

La propriété correlationid doit être définie pour chaque corrélation, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

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

Paramètre Type Description
filter object Objet filtre de corrélation remplaçant le filtre actuel.
operations array Opérations de corrélation remplaçant les opérations existantes.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des corrélations mises à jour dans la propriété correlationids.

Exemples

Désactiver la corrélation

Requête:

{
    "jsonrpc": "2.0",
    "method": "correlation.update",
    "params": {
        "correlationid": "1",
        "status": "1"
    },
    "id": 1
}

Réponse :

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

Remplacer les conditions, mais conserver la méthode d’évaluation

Requête:

{
    "jsonrpc": "2.0",
    "method": "correlation.update",
    "params": {
        "correlationid": "1",
        "filter": {
            "conditions": [
                {
                    "type": 3,
                    "oldtag": "error",
                    "newtag": "ok"
                }
            ]
        }
    },
    "id": 1
}

Réponse :

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

Voir également

Source

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