[comment]: # translation:outdated

[comment]: # ({c7f202d4-c7f202d4})
# action.create

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

[comment]: # ({71c93aa0-71c93aa0})
### Description

`object action.create(object/array actions)`

Cette méthode permet de créer de nouvelles actions.

::: noteclassic
Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::

[comment]: # ({/71c93aa0-71c93aa0})

[comment]: # ({52238aaf-5a9be3c9})
### Paramètres

`(object/array)` Actions à créer.

En plus des [propriétés d'action standard](object#action), la méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data_types)|Description|
|---------|---------------------------------------------------|-----------|
|filter|object|Objet de [filtre](/manual/api/reference/action/object#action_filter) d'action pour l'action.|
|operations|array|[Opérations](/manual/api/reference/action/object#action_operation) d'action à créer pour l'action.|
|recovery\_operations|array|[Opérations de récupération](/manual/api/reference/action/object#action_recovery_operation) d'action à créer pour l'action.|
|update\_operations|array|[Opérations de mise à jour](/manual/api/reference/action/object#action_update_operation) d'action à créer pour l'action.|

[comment]: # ({/52238aaf-5a9be3c9})

[comment]: # ({2830affd-2830affd})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des actions créées sous la propriété `actionids`. L'ordre des ID retournés correspond à l'ordre des actions transmises.

[comment]: # ({/2830affd-2830affd})

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

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

[comment]: # ({34096b6e-afc96865})
#### Créer une action de déclenchement

Créez une action de déclencheur qui commencera une fois qu'un déclencheur (avec le mot "mémoire" dans son nom) de l'hôte "10084" passera à l'état PROBLÈME.
L'action aura 4 opérations configurées.
La première opération immédiate enverra un message à tous les utilisateurs du groupe d'utilisateurs "7" via le type de média "1".
Si l'événement n'est pas résolu en 30 minutes, la deuxième opération s'exécutera [script](/manual/web_interface/frontend_sections/administration/scripts#configuration-dun-script-global) "5" (script avec la portée "Action operation") sur tous les hôtes du groupe "2".
Si l'événement est résolu, une opération de récupération informera tous les utilisateurs qui ont reçu des messages concernant le problème.
Si l'événement est mis à jour, une opération d'accusé de réception/de mise à jour notifiera (avec un objet et un message personnalisés) tous les utilisateurs qui ont reçu des messages concernant le problème.

Requête :

```json
{
    "jsonrpc": "2.0",
    "method": "action.create",
    "params": {
        "name": "Trigger action",
        "eventsource": 0,
        "esc_period": "30m",
        "filter": {
            "evaltype": 0,
            "conditions": [
                {
                    "conditiontype": 1,
                    "operator": 0,
                    "value": "10084"
                },
                {
                    "conditiontype": 3,
                    "operator": 2,
                    "value": "memory"
                }
            ]
        },
        "operations": [
            {
                "operationtype": 0,
                "esc_step_from": 1,
                "esc_step_to": 1,
                "opmessage_grp": [
                    {
                        "usrgrpid": "7"
                    }
                ],
                "opmessage": {
                    "default_msg": 1,
                    "mediatypeid": "1"
                }
            },
            {
                "operationtype": 1,
                "esc_step_from": 2,
                "esc_step_to": 2,
                "opconditions": [
                    {
                        "conditiontype": 14,
                        "operator": 0,
                        "value": "0"
                    }
                ],
                "opcommand_grp": [
                    {
                        "groupid": "2"
                    }
                ],
                "opcommand": {
                    "scriptid": "5"
                }
            }
        ],
        "recovery_operations": [
            {
                "operationtype": "11",
                "opmessage": {
                    "default_msg": 1
                }
            }    
        ],
        "update_operations": [
            {
                "operationtype": "12",
                "opmessage": {
                    "default_msg": 0,
                    "message": "Custom update operation message body",
                    "subject": "Custom update operation message subject"
                }
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

```json
{
    "jsonrpc": "2.0",
    "result": {
        "actionids": [
            "17"
        ]
    },
    "id": 1
}
```

[comment]: # ({/34096b6e-afc96865})

[comment]: # ({4e47d40a-53bdbb4b})
#### Créer une action de découverte

Créer une action qui liera les hôtes découverts au modèle "10001".

Requête :

```json
{
    "jsonrpc": "2.0",
    "method": "action.create",
    "params": {
        "name": "Discovery action",
        "eventsource": 1,
        "filter": {
            "evaltype": 0,
            "conditions": [
                {
                    "conditiontype": 21,
                    "operator": 0,
                    "value": "1"
                },
                {
                    "conditiontype": 10,
                    "operator": 0,
                    "value": "2"
                }
            ]
        },
        "operations": [
            {
                "operationtype": 6,
                "optemplate": [
                    {
                        "templateid": "10001"
                    }
                ]
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

```json
{
    "jsonrpc": "2.0",
    "result": {
        "actionids": [
            "18"
        ]
    },
    "id": 1
}
```

[comment]: # ({/4e47d40a-53bdbb4b})

[comment]: # ({56bf3fe7-de84bbc4})
#### Utilisation d'un filtre d'expression personnalisé

Créez une action de déclencheur qui utilisera une condition de filtre personnalisée. L'action doit envoyer un message pour chaque déclencheur avec une sévérité supérieure ou égale à "Warning" pour les hosts "10084" et "10106". Les identifiants de formule "A", "B" et "C" ont été choisis arbitrairement.

Requête :

```json
{
    "jsonrpc": "2.0",
    "method": "action.create",
    "params": {
        "name": "Trigger action",
        "eventsource": 0,
        "status": 0,
        "esc_period": "2m",
        "filter": {
            "evaltype": 3,
            "formula": "A and (B or C)",
            "conditions": [
                {
                    "conditiontype": 4,
                    "operator": 5,
                    "value": "2",
                    "formulaid": "A"
                },
                {
                    "conditiontype": 1,
                    "operator": 0,
                    "value": "10084",
                    "formulaid": "B"
                },
                {
                    "conditiontype": 1,
                    "operator": 0,
                    "value": "10106",
                    "formulaid": "C"
                }
            ]
        },
        "operations": [
            {
                "operationtype": 0,
                "esc_period": "0s",
                "esc_step_from": 1,
                "esc_step_to": 2,
                "evaltype": 0,
                "opmessage_grp": [
                    {
                        "usrgrpid": "7"
                    }
                ],
                "opmessage": {
                    "default_msg": 1,
                    "mediatypeid": "1"
                }
            }
        ],
        "pause_suppressed": "0",
        "notify_if_canceled": "0"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

```json
{
    "jsonrpc": "2.0",
    "result": {
        "actionids": [
            "18"
        ]
    },
    "id": 1
}
```

[comment]: # ({/56bf3fe7-de84bbc4})

[comment]: # ({159ac679-b81a306b})
#### Créer une règle d'enregistrement automatique des agents

Ajoutez un hôte au groupe d'hôtes "Linux servers" lorsque le nom d'hôte contient "SRV" ou que les métadonnées contiennent "AlmaLinux".

Requête :

```json
{
    "jsonrpc": "2.0",
    "method": "action.create",
    "params": {
        "name": "Register Linux servers",
        "eventsource": "2",
        "status": "0",
        "filter": {
            "evaltype": "2",
            "conditions": [
                {
                    "conditiontype": "22",
                    "operator": "2",
                    "value": "SRV"
                },
                {
                    "conditiontype": "24",
                    "operator": "2",
                    "value": "AlmaLinux"
                }
            ]
        },
        "operations": [
            {
                "operationtype": "4",
                "opgroup": [
                    {
                        "groupid": "2"
                    }
                ]
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

```json
{
    "jsonrpc": "2.0",
    "result": {
        "actionids": [
            19
        ]
    },
    "id": 1
}
```

[comment]: # ({/159ac679-b81a306b})

[comment]: # ({0f0e8283-755496f7})
### Voir également

-   [Filtre d'action](object#action_filter)
-   [Opération d'action](object#action_operation)
-   [Script](/manual/api/reference/script/object)

[comment]: # ({/0f0e8283-755496f7})

[comment]: # ({32335876-32335876})
### Source

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

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