[comment]: # translation:outdated

[comment]: # ({fbeccd23-fbeccd23})
# correlation.create

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

[comment]: # ({c06fb521-c06fb521})
### Description

`objet correlation.create(objet/tableau corrélations)`

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

::: noteclassic
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](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::

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

[comment]: # ({b9742898-8a55e636})
### Paramètres

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

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

|Paramètre|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**operations**<br>(obligatoire)|array|[Opérations](/manual/api/reference/correlation/object#correlation_operation) de corrélation à créer pour la corrélation.|
|**filter**<br>(obligatoire)|object|Objet de [filtre](/manual/api/reference/correlation/object#correlation_filter)  de corrélation pour la corrélation.|

[comment]: # ({/b9742898-8a55e636})

[comment]: # ({88660193-88660193})
### 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.

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

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

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

[comment]: # ({7325d5f8-7325d5f8})
#### 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 :

``` {.java}
{
 "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 :

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

[comment]: # ({/7325d5f8-7325d5f8})

[comment]: # ({a12df7f6-a12df7f6})
#### 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 :

``` {.java}
{
    "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 :

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

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

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

- [Filtre de corrélation](object#correlation_filter)
- [Opération de corrélation](object#correlation_operation)

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

[comment]: # ({934ba89b-934ba89b})
### Source

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

[comment]: # ({/934ba89b-934ba89b})