hostgroup.update

Beschreibung

object hostgroup.update(object/array hostGroups)

Diese Methode ermöglicht die Aktualisierung bestehender Host-Gruppen.

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

Parameter

(object/array) Host group properties, die aktualisiert werden sollen.

Die Eigenschaft groupid muss für jede Host group 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.