[comment]: # translation:outdated

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

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

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

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

Cette méthode permet de mettre à jour des services existants.

::: noteclassic
Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations
d’appeler la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir [User
roles](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d’informations.
:::

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

[comment]: # ({7f072363-5fb5ebb3})
### Paramètres

`(object/array)` propriétés du service à mettre à jour.

La propriété `serviceid` doit être définie pour chaque service, 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 de service standard](object#service), la
méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)| Description|
|--|--|------|
|children|array|[Services](/manual/api/reference/service/object#service) enfants remplaçant les services enfants actuels.<br><br>Seule la propriété `serviceid` doit être définie pour les services enfants.|
|parents|array|[Services](/manual/api/reference/service/object#service) parents remplaçant les services parents actuels.<br><br>Seule la propriété `serviceid` doit être définie pour les services parents.|
|tags|array|[Tags de service](/manual/api/reference/service/object#service-tag) remplaçant les tags de service actuels.|
|problem\_tags|array|[Tags de problème](/manual/api/reference/service/object#problem-tag) remplaçant les tags de problème actuels.|
|status\_rules|array|[Règles de statut](/manual/api/reference/service/object#status-rule) remplaçant les règles de statut actuelles.|

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

[comment]: # ({9465ee4d-9465ee4d})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des services mis à jour sous la propriété `serviceids`.

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

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

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

[comment]: # ({3db3fe16-b9918036})
#### Définir le parent d’un service

Définissez le service avec l’ID "3" comme parent du service avec l’ID "5".

[Requête](/manual/api#performing-requests):

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

Réponse :

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

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

[comment]: # ({96cfca7d-263b1baa})
#### Ajout d’un temps d’arrêt planifié

Ajoutez un temps d’arrêt pour le service avec l’ID « 4 », planifié chaque semaine du lundi
22:00 au mardi 10:00.

[Requête](/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
}
```

Réponse :

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

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

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

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

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