service.update

Description

object service.update(object/array services)

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

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 pour plus d’informations.

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, la méthode accepte les paramètres suivants.

Paramètre Type Description
children array Services enfants remplaçant les services enfants actuels.

Seule la propriété serviceid doit être définie pour les services enfants.
parents array Services parents remplaçant les services parents actuels.

Seule la propriété serviceid doit être définie pour les services parents.
tags array Tags de service remplaçant les tags de service actuels.
problem_tags array Tags de problème remplaçant les tags de problème actuels.
status_rules array Règles de statut remplaçant les règles de statut actuelles.

Valeurs retournées

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

Exemples

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:

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

Réponse :

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

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 :

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

Réponse :

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

Source

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