hostgroup.create

Beschreibung

object hostgroup.create(object/array hostGroups)

Diese Methode ermöglicht es Ihnen, neue Hostgruppen zu 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 widerrufen 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.