service.create

Beschreibung

object service.create(object/array services)

Mit dieser Methode können Sie neue Services erstellen.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.

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.