[comment]: # ({c71a2e54-c71a2e54})
# correlation.update

[comment]: # ({/c71a2e54-c71a2e54})

[comment]: # ({d60edf58-b9562236})
### Description

`object correlation.update(object/array correlations)`

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

[comment]: # ({/d60edf58-b9562236})

[comment]: # ({ae6089a8-326bc80e})
### 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
passées seront mises à jour, toutes les autres resteront inchangées.

En plus des [propriétés de corrélation standard](object#correlation), la
méthode accepte les paramètres suivants.

|Paramètre|Type|Description|
|----------|----|-----------|
|filter|object|Objet filtre de corrélation pour remplacer le filtre actuel.|
|operations|array|Opérations de corrélation pour remplacer les opérations existantes.|

[comment]: # ({/ae6089a8-326bc80e})

[comment]: # ({953dd427-13e1dc13})
### Valeurs de retour

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

[comment]: # ({/953dd427-13e1dc13})

[comment]: # ({88e43968-b41637d2})
### Exemples

[comment]: # ({/88e43968-b41637d2})

[comment]: # ({467a49fd-67bb2dfb})
#### Désactiver la corrélation

Requête:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "correlation.update",
    "params": {
        "correlationid": "1",
        "status": "1"
    },
    "auth": "343baad4f88b4106b9b5961e77437688",
    "id": 1
}
```

Réponse:

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

[comment]: # ({/467a49fd-67bb2dfb})

[comment]: # ({6e9f955b-d6ef1778})
#### Remplacer les conditions, mais conserver la méthode d'évaluation

Requête:

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

Réponse:

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

[comment]: # ({/6e9f955b-d6ef1778})

[comment]: # ({d890b34f-e7d15410})
### Voir également

-   [Filtre de Corrélation](object#filtre_de_correlation)
-   [Opération de Corrélation](object#operation_de_correlation)

[comment]: # ({/d890b34f-e7d15410})

[comment]: # ({f8a19cca-40fa665f})
### Source

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

[comment]: # ({/f8a19cca-40fa665f})