service.update

Descrizione

object service.update(object/array services)

Questo metodo consente di aggiornare servizi esistenti.

Questo metodo è disponibile per utenti di qualsiasi tipo. I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Vedere Ruoli utente per ulteriori informazioni.

Parametri

(object/array) proprietà del servizio da aggiornare.

La proprietà serviceid deve essere definita per ciascun servizio, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte le altre rimarranno invariate.

Oltre alle proprietà standard del servizio, il metodo accetta i seguenti parametri.

Parametro Type Descrizione
children array Servizi figli per sostituire gli attuali servizi figli.

I servizi figli devono avere definita solo la proprietà serviceid.
parents array Servizi padre per sostituire gli attuali servizi padre.

I servizi padre devono avere definita solo la proprietà serviceid.
tags array Tag del servizio per sostituire gli attuali tag del servizio.
problem_tags array Tag del problema per sostituire gli attuali tag del problema.
status_rules array Regole di stato per sostituire le attuali regole di stato.

Valori di ritorno

(object) Restituisce un oggetto contenente gli ID dei servizi aggiornati sotto la proprietà serviceids.

Esempi

Impostazione del parent per un servizio

Impostare il servizio con ID "3" come parent del servizio con ID "5".

Richiesta:

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

Risposta:

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

Aggiunta di un periodo di inattività pianificato

Aggiungere un periodo di inattività per il servizio con ID "4", pianificato settimanalmente dal lunedì alle 22:00 fino al martedì alle 10:00.

Request:

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

Risposta:

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

Fonte

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