service.create

Beschreibung

object service.create(object/array services)

Mit dieser Methode können neue Services erstellt 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 User roles.

Parameter

(object/array) zu erstellende Services.

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

Parameter Typ Beschreibung
children array Untergeordnete Services, die mit dem Service verknüpft werden sollen.

Für die untergeordneten Services darf nur die Eigenschaft serviceid definiert sein.
parents array Übergeordnete Services, die mit dem Service verknüpft werden sollen.

Für die übergeordneten Services darf nur die Eigenschaft serviceid definiert sein.
tags array Service-Tags, die für den Service erstellt werden sollen.
problem_tags array Problem-Tags, die für den Service erstellt werden sollen.
status_rules array Statusregeln, die für den Service erstellt werden sollen.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der erstellten Services unter der Eigenschaft serviceids enthält. Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Services.

Beispiele

Erstellen eines Service

Erstellen Sie einen Service, der in den Problemstatus wechselt, wenn mindestens ein untergeordneter Service ein Problem hat.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "service.create",
    "params": {
        "name": "Server 1",
        "algorithm": 1,
        "sortorder": 1
    },
    "id": 1
}

Antwort:

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

Quelle

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