service.update

Beschreibung

object service.update(object/array services)

Mit dieser Methode können vorhandene Services aktualisiert werden.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) zu aktualisierende Service-Eigenschaften.

Die Eigenschaft serviceid muss für jeden Service definiert sein, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Zusätzlich zu den Standard-Service-Eigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Type Beschreibung
children array Untergeordnete Services, die die aktuellen untergeordneten Services ersetzen.

Für die untergeordneten Services darf nur die Eigenschaft serviceid definiert sein.
parents array Übergeordnete Services, die die aktuellen übergeordneten Services ersetzen.

Für die übergeordneten Services darf nur die Eigenschaft serviceid definiert sein.
tags array Service-Tags, die die aktuellen Service-Tags ersetzen.
problem_tags array Problem-Tags, die die aktuellen Problem-Tags ersetzen.
status_rules array Statusregeln, die die aktuellen Statusregeln ersetzen.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Services unter der Eigenschaft serviceids enthält.

Beispiele

Festlegen des übergeordneten Service für einen Service

Legen Sie den Service mit der ID „3“ als übergeordneten Service für den Service mit der ID „5“ fest.

Anfrage:

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

Antwort:

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

Hinzufügen einer geplanten Ausfallzeit

Fügen Sie für den Service mit der ID „4“ eine Ausfallzeit hinzu, die wöchentlich von Montag 22:00 Uhr bis Dienstag 10:00 Uhr geplant ist.

Anfrage:

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

Antwort:

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

Quelle

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