[comment]: # translation:outdated

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

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

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

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

Diese Methode ermöglicht das Aktualisieren vorhandener Aktionen.

::: noteclassic
Diese Methode ist nur für die Benutzertypen *Admin* und *Super Admin* verfügbar.
Berechtigungen zum Aufrufen der Methode können in den Benutzerrolleneinstellungen widerrufen
werden. Weitere Informationen finden Sie unter [Benutzerrollen]
(/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Zu aktualisierende Aktionseigenschaften.

Die Eigenschaft `actionid` muss für jede Aktion definiert werden, alle anderen
Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle
anderen bleiben unverändert.

Zusätzlich zu den [Standard-Aktionseigenschaften](object#action) akzeptiert die
Methode die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|filter|object|Objekt [Aktionsfilter](/manual/api/reference/action/object#action-filter), das den aktuellen Filter ersetzt.|
|operations|array|[Aktionsoperationen](/manual/api/reference/action/object#action-operation), die bestehende Operationen ersetzen.|
|recovery\_operations|array|[Aktions-Wiederherstellungsoperationen](/manual/api/reference/action/object#action-recovery-operation), die bestehende Wiederherstellungsoperationen ersetzen.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn `eventsource` des [Aktionsobjekts](/manual/api/reference/action/object#action) auf „durch einen Auslöser erstelltes Ereignis“, „internes Ereignis“ oder „bei Aktualisierung des Servicestatus erstelltes Ereignis“ gesetzt ist|
|update\_operations|array|[Aktions-Aktualisierungsoperationen](/manual/api/reference/action/object#action-update-operation), die bestehende Aktualisierungsoperationen ersetzen.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn `eventsource` des [Aktionsobjekts](/manual/api/reference/action/object#action) auf „durch einen Auslöser erstelltes Ereignis“ oder „bei Aktualisierung des Servicestatus erstelltes Ereignis“ gesetzt ist|

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

[comment]: # ({8cbaa103-8cbaa103})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der aktualisierten Aktionen
unter der Eigenschaft `actionids` enthält.

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

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

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

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

Eine Aktion deaktivieren, d. h. ihren Status auf „1“ setzen.

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

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

Antwort:

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

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

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

-   [Aktionsfilter](object#action-filter)
-   [Aktionsoperation](object#action-operation)

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

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

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

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