hostgroup.create

Beschreibung

object hostgroup.create(object/array hostGroups)

Mit dieser Methode können Sie neue Hostgruppen erstellen.

Diese Methode ist nur für den Benutzertyp Super-Admin verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu erstellende Host-Gruppen.

Die Methode akzeptiert Host-Gruppen mit den Standard-Host-Gruppeneigenschaften.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der erstellten Host-Gruppen unter der Eigenschaft groupids enthält. Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Wirtsgruppen.

Beispiele

Erstellen einer Host-Gruppe

Erstellen Sie eine Host-Gruppe mit dem Namen „Linux servers“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.create",
    "params": {
        "name": "Linux servers"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "107819"
        ]
    },
    "id": 1
}

Quelle

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