hostgroup.massadd

Beschreibung

object hostgroup.massadd(object parameters)

Diese Methode ermöglicht es Ihnen, mehrere zusammengehörige Objekte gleichzeitig zu allen angegebenen Hostgruppen hinzuzufügen.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufruf der Methode kann in den Einstellungen der Benutzerrolle widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.

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.