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) 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
}

Umbenennen mehrerer Host-Gruppen

Benennen Sie zwei Host-Gruppen um, um Regionsinformationen in ihre Namen aufzunehmen.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": [
        {
            "groupid": "8",
            "name": "Europe/Linux hosts"
        },
        {
            "groupid": "9",
            "name": "Europe/Windows hosts"
        }
    ],
    "id": 1
}

Antwort:

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

Quelle

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