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 Hostgruppen, die aktualisiert werden sollen.

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

Parameterverhalten:
- erforderlich
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.

Parameterverhalten:
- erforderlich

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Hostgruppen 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.