hostgroup.massupdate

Beschreibung

object hostgroup.massupdate(object parameters)

Diese Methode ermöglicht es, Hosts und Vorlagen in mehreren Hostgruppen durch die angegebenen zu ersetzen.

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

Parameter

(object) Parameter, die die IDs der zu aktualisierenden Hostgruppen und die Objekte enthalten, die aktualisiert werden sollen.

Parameter Type Description
groups object/array Host groups, die aktualisiert werden sollen.

Die Hostgruppen dürfen nur die Eigenschaft groupid definiert haben.

Parameter behavior:
- required
hosts object/array Hosts, die die aktuellen Hosts in den angegebenen Hostgruppen ersetzen sollen.
Alle anderen Hosts, außer den genannten, werden aus den Hostgruppen ausgeschlossen.
Erkannte Hosts sind davon nicht betroffen.

Die Hosts dürfen nur die Eigenschaft hostid definiert haben.

Parameter behavior:
- required

Rückgabewerte

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

Beispiele

Ersetzen von Hosts in einer Hostgruppe

Ersetzen Sie alle Hosts in einer Hostgruppe durch den genannten Host.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.massupdate",
    "params": {
        "groups": [
            {
                "groupid": "6"
            }
        ],
        "hosts": [
            {
                "hostid": "30050"
            }
        ]
    },
    "id": 1
}

Antwort:

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

Siehe auch

Quelle

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