hostgroup.massadd

Beschreibung

object hostgroup.massadd(object parameters)

Mit dieser Methode können mehrere verknüpfte Objekte gleichzeitig zu allen angegebenen Host-Gruppen hinzugefügt werden.

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

Parameter

(object) Parameter, die die IDs der zu aktualisierenden Host-Gruppen und die Objekte enthalten, die zu allen Host-Gruppen hinzugefügt werden.

Die Methode akzeptiert die folgenden Parameter.

Parameter Type Beschreibung
groups object/array Zu aktualisierende Host-Gruppen.

Für die Host-Gruppen darf nur die Eigenschaft groupid definiert sein.

Parameter behavior:
- erforderlich
hosts object/array Hosts, die zu allen Host-Gruppen hinzugefügt werden sollen.

Für die Hosts darf nur die Eigenschaft hostid definiert sein.

Rückgabewerte

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

Beispiele

Hinzufügen von Hosts zu Host-Gruppen

Fügen Sie zwei Hosts zu Host-Gruppen mit den IDs 5 und 6 hinzu.

Anfrage:

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

Antwort:

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

Siehe auch

Quelle

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