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

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

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

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

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

::: noteclassic
Cette méthode est disponible à tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::

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

[comment]: # ({4ccd379d-4ccd379d})
### Paramètres

Les propriétés du service `(object/array)` doivent être mises à jour.

La propriété `serviceid` doit être définie pour chaque service, toutes les autres les propriétés sont facultatives. Seules les propriétés passées 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) | Descriptif |
|---------------|--------------------------------------------- --------------------|-------------------------------------- -------------------------------------------------- ------------------------------------------|
| enfants | array | Services enfants pour remplacer les enfants de service actuels.<br><br>Les enfants doivent avoir la propriété `serviceid` définie. |
| parents | array | Services parents pour remplacer les services parents actuels.<br><br>Les parents doivent avoir la propriété `serviceid` définie. |
| balises | array | [Tags de service](/manual/api/reference/service/object#service_tag) en rempalcement des tags de service actuels. |
| problème\_tags | array | [Tags de problème](/manual/api/reference/service/object#problem_tag) en remplacement des tags de problème actuelles. |
| statut\_règles | array | [Règles de statut](/manual/api/reference/service/object#status_rule) en remplacement des règles de statut actuelles. |

[comment]: # ({/4ccd379d-4ccd379d})

[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]: # ({2b175bc4-b9918036})
#### Définition du parent d'un service

Faites en sorte que le service avec l'ID "3" soit le parent du service avec l'ID "5".

Requête :

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

Réponse :

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

[comment]: # ({/2b175bc4-b9918036})

[comment]: # ({7e5835e2-263b1baa})
#### Ajout d'un temps d'arrêt planifié

Ajoutez un temps d'arrêt pour le service avec l'ID "4" programmé chaque semaine du lundi 22h00 au mardi 10h00.

Requête :

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

Réponse :

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

[comment]: # ({/7e5835e2-263b1baa})

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

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

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