service.update

Beschreibung

object service.update(object/array services)

Diese Methode ermöglicht es Ihnen, vorhandene Services zu aktualisieren.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigung zum Aufruf der Methode kann in den Einstellungen der Benutzerrolle widerrufen 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.