service.update

Opis

object service.update(object/array services)

Ta metoda umożliwia aktualizację istniejących usług.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object/array) właściwości usługi do zaktualizowania.

Właściwość serviceid musi być zdefiniowana dla każdej usługi, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

Oprócz standardowych właściwości usługi, metoda akceptuje następujące parametry.

Parametr Type Opis
children array Podrzędne usługi, które zastąpią bieżące usługi podrzędne.

Usługi podrzędne muszą mieć zdefiniowaną wyłącznie właściwość serviceid.
parents array Nadrzędne usługi, które zastąpią bieżące usługi nadrzędne.

Usługi nadrzędne muszą mieć zdefiniowaną wyłącznie właściwość serviceid.
tags array Tagi usługi, które zastąpią bieżące tagi usługi.
problem_tags array Tagi problemów, które zastąpią bieżące tagi problemów.
status_rules array Reguły statusu, które zastąpią bieżące reguły statusu.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych usług we właściwości serviceids.

Przykłady

Ustawianie usługi nadrzędnej dla usługi

Ustaw usługę o ID „3” jako usługę nadrzędną dla usługi o ID „5”.

Żądanie:

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

Odpowiedź:

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

Dodawanie zaplanowanego przestoju

Dodaj przestój dla usługi o ID „4”, zaplanowany co tydzień od poniedziałku 22:00 do wtorku 10:00.

Żądanie:

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

Odpowiedź:

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

Źródło

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