[comment]: # translation:outdated

[comment]: # ({e4b5aac4-e4b5aac4})
# action.update

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

[comment]: # ({753e174e-b1673b49})
### Description

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

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

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

[comment]: # ({/753e174e-b1673b49})

[comment]: # ({b2bf859d-703e85ce})
### Paramètres

`(object/array)` Propriétés d'action à mettre à jour.

La propriété `actionid` doit être définie pour chaque action, 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 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 [filtre d'action](/manual/api/reference/action/object#action-filter) pour remplacer le filtre actuel.|
|operations|array|[Opérations d'action](/manual/api/reference/action/object#action-operation) pour remplacer les opérations existantes.|
|recovery\_operations|array|[Opérations de récupération d'action](/manual/api/reference/action/object#action-recovery-operation) pour remplacer les opérations de récupération existantes.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *pris en charge* si `eventsource` de l'[objet action](/manual/api/reference/action/object#action) est défini sur "événement créé par un déclencheur", "événement interne" ou "événement créé lors de la mise à jour de l'état du service"|
|update\_operations|array|[Opérations de mise à jour d'action](/manual/api/reference/action/object#action-update-operation) pour remplacer les opérations de mise à jour existantes.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *pris en charge* si `eventsource` de l'[objet action](/manual/api/reference/action/object#action) est défini sur "événement créé par un déclencheur" ou "événement créé lors de la mise à jour de l'état du service"|

[comment]: # ({/b2bf859d-703e85ce})

[comment]: # ({8cbaa103-8cbaa103})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des actions mises à jour sous la propriété `actionids`.

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

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

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

[comment]: # ({6695ece3-77b78ec5})
#### Désactiver l'action

Désactive l'action, c'est-à-dire définir son statut sur "1".

[Requête](/manual/api#effectuer-des-requêtes) :

```json
{
    "jsonrpc": "2.0",
    "method": "action.update",
    "params": {
        "actionid": "2",
        "status": "1"
    },
    "id": 1
}
```

Réponse :

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

[comment]: # ({/6695ece3-77b78ec5})

[comment]: # ({7ab40057-755496f7})
### Voir aussi

-   [Filtre d'action](object#action-filter)
-   [Opération d'action](object#action-operation)

[comment]: # ({/7ab40057-755496f7})

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

CAction::update() in *ui/include/classes/api/services/CAction.php*.

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