[comment]: # translation:outdated

[comment]: # ({cd4a930c-cd4a930c})
# service.update

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

[comment]: # ({5044bc6a-79afe9b7})
### Beschreibung

`object service.update(object/array services)`

Mit dieser Methode können vorhandene Services aktualisiert werden.

::: noteclassic
Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen
zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/5044bc6a-79afe9b7})

[comment]: # ({7f072363-5fb5ebb3})
### Parameter

`(object/array)` zu aktualisierende Service-Eigenschaften.

Die Eigenschaft `serviceid` muss für jeden Service definiert sein, alle anderen
Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle
anderen bleiben unverändert.

Zusätzlich zu den [Standard-Service-Eigenschaften](object#service) akzeptiert die
Methode die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)| Beschreibung|
|--|--|------|
|children|array|Untergeordnete [Services](/manual/api/reference/service/object#service), die die aktuellen untergeordneten Services ersetzen.<br><br>Für die untergeordneten Services darf nur die Eigenschaft `serviceid` definiert sein.|
|parents|array|Übergeordnete [Services](/manual/api/reference/service/object#service), die die aktuellen übergeordneten Services ersetzen.<br><br>Für die übergeordneten Services darf nur die Eigenschaft `serviceid` definiert sein.|
|tags|array|[Service-Tags](/manual/api/reference/service/object#service-tag), die die aktuellen Service-Tags ersetzen.|
|problem\_tags|array|[Problem-Tags](/manual/api/reference/service/object#problem-tag), die die aktuellen Problem-Tags ersetzen.|
|status\_rules|array|[Statusregeln](/manual/api/reference/service/object#status-rule), die die aktuellen Statusregeln ersetzen.|

[comment]: # ({/7f072363-5fb5ebb3})

[comment]: # ({9465ee4d-9465ee4d})
### Rückgabewerte

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

[comment]: # ({/9465ee4d-9465ee4d})

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

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

[comment]: # ({3db3fe16-b9918036})
#### Festlegen des übergeordneten Service für einen Service

Legen Sie den Service mit der ID „3“ als übergeordneten Service für den Service mit der ID „5“ fest.

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

```json
{
    "jsonrpc": "2.0",
    "method": "service.update",
    "params": {
        "serviceid": "5",
        "parents": [
            {
                "serviceid": "3"
            }
        ]
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "serviceids": [
            "5"
        ]
    },
    "id": 1
}
```

[comment]: # ({/3db3fe16-b9918036})

[comment]: # ({96cfca7d-263b1baa})
#### Hinzufügen einer geplanten Ausfallzeit

Fügen Sie für den Service mit der ID „4“ eine Ausfallzeit hinzu, die wöchentlich von Montag
22:00 Uhr bis Dienstag 10:00 Uhr geplant ist.

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

```json
{
    "jsonrpc": "2.0",
    "method": "service.update",
    "params": {
        "serviceid": "4",
        "times": [
            {
                "type": "1",
                "ts_from": "165600",
                "ts_to": "201600"
            }
        ]
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "serviceids": [
            "4"
        ]
    },
    "id": 1
}
```

[comment]: # ({/96cfca7d-263b1baa})

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

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

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