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

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

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

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

Aquest mètode permet actualitzar les accions.

::: noteclassic
Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

[comment]: # ({b2bf859d-703e85ce})
### Paràmetres

`(object/array)` Propietats de l'acció que s'actualitzaran.

La propietat `actionid` s'ha de definir per a cada acció; les altres propietats són opcionals. Només les propietats facilitades s'actualitzaran, les altres romandran sense canvis.

A més de les [propietats d'acció per defecte](object#action), el mètode accepta els paràmetres següents:

|Paràmetre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció|
|--|--|------|
|filter|objecte|[Filtre d'acció](/manual/api/reference/action/object#action-filter) objecte per a substituir el filtre actual.|
|operations|taula|[operacions d'acció](/manual/api/reference/action/object#action-operation) per a substituir les operacions existents.|
|recovery\_operations|array|Operacions de recuperació d'acció](/manual/api/reference/action/object#action-recovery-operation) per a substituir les operacions de recuperació existents.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si `eventsource' d'[objecte d'acció](/manual/api/reference/action/object #action) s'estableix a "esdeveniment creat per un trigger", "esdeveniment intern" o "esdeveniment creat a l'actualització de l'estat del servei"||
|update\_operations|array|[Operacions d'actualització d'acció](/manual/api/reference/action/object#action_update_operation) per a substituir les operacions d'actualització existents.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si `eventsource' d'[objecte acció](/manual/api/reference/action/object #action) s'estableix a "esdeveniment creat per un trigger" o "esdeveniment creat a l'actualització de l'estat del servei"|

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

[comment]: # ({8cbaa103-8cbaa103})
### Valors de retorn

`(object)` Retorna un objecte contingut als IDs de les accions actualitzades sota la propietat `actionids`.

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

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

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

[comment]: # ({6695ece3-77b78ec5})
#### Desactivar una acció

Desactivar accions; és a dir: establir el seu estat a "1".

[Consulta](/manual/api#performing-requests):

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

Resposta:

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

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

[comment]: # ({7ab40057-755496f7})
### Veieu també

-   [Filtre d'acció](object#action-filter)
-   [Operació d'acció](object#action-operation)

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

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

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

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