service.update

Opis

object service.update(object/array services)

Ta metoda pozwala na aktualizację istniejących usług.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz Role użytkownika aby uzyskać więcej informacji.

Parametry

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

Właściwość serviceid musi być zdefiniowana dla każdej usługi, wszystkie inne właściwości są opcjonalne. Tylko przekazane właściwości zostaną zaktualizowane, pozostałe pozostaną niezmienione.

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

Parametr Typ Opis
children array Usługi podrzędne do zastąpienia aktualnych usług podrzędnych.

Usługi podrzędne muszą mieć zdefiniowaną właściwość serviceid.
parents array Usługi nadrzędne do zastąpienia aktualnych usług nadrzędnych.

Usługi nadrzędne muszą mieć zdefiniowaną właściwość serviceid.
tags array Znaczniki usług do zastąpienia aktualnymi znacznikami usługi.
problem_tags array Znaczniki problemów do zastąpienia aktualnymi znacznikami problemów.
status_rules array Reguły statusu do zastąpienia aktualnymi regułami 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 identyfikatorze "3" jako nadrzędną dla usługi o identyfikatorze "5".

Zapytanie:

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

Odpowiedź:

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

Dodawanie planowanego przestoju

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

Zapytanie:

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

Odpowiedź:

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

Źródło

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