hostgroup.update

Beschreibung

object hostgroup.update(object/array hostGroups)

Mit dieser Methode können Sie vorhandene Hostgruppen aktualisieren.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) zu aktualisierende Host-Gruppen-Eigenschaften.

Die Eigenschaft groupid muss für jede Host-Gruppe definiert sein, alle anderen Eigenschaften sind optional. Nur die angegebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Host-Gruppen unter der Eigenschaft groupids enthält.

Beispiele

Umbenennen einer Host-Gruppe

Benennen Sie eine Host-Gruppe in „Linux hosts“ um.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": {
        "groupid": "7",
        "name": "Linux hosts"
    },
    "id": 1
}

Antwort:

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

Quelle

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