host.massadd
Beschreibung
object host.massadd(object parameters)
Mit dieser Methode können mehreren angegebenen Hosts gleichzeitig mehrere zugehörige Objekte hinzugefügt werden.
Diese Methode ist nur für Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.
Parameter
(object) Parameter, die die IDs der zu aktualisierenden Hosts und die
Objekte enthalten, die zu allen Hosts hinzugefügt werden sollen.
Die Methode akzeptiert die folgenden Parameter.
| Parameter | Type | Beschreibung |
|---|---|---|
| hosts | object/array | Hosts, die aktualisiert werden sollen. Für die Hosts darf nur die Eigenschaft hostid definiert sein.Parameterverhalten: - erforderlich |
| groups | object/array | Host-Gruppen, die zu den angegebenen Hosts hinzugefügt werden sollen. Für die Host-Gruppen darf nur die Eigenschaft groupid definiert sein. |
| interfaces | object/array | Host-Schnittstellen, die für die angegebenen Hosts erstellt werden sollen. |
| macros | object/array | Benutzermakros, die für die angegebenen Hosts erstellt werden sollen. |
| templates | object/array | Vorlagen, die mit den angegebenen Hosts verknüpft werden sollen. Für die Vorlagen darf nur die Eigenschaft templateid definiert sein. |
Rückgabewerte
(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Hosts
unter der Eigenschaft hostids enthält.
Beispiele
Makros hinzufügen
Fügen Sie zwei neue Makros zu zwei Hosts hinzu.
{
"jsonrpc": "2.0",
"method": "host.massadd",
"params": {
"hosts": [
{
"hostid": "10160"
},
{
"hostid": "10167"
}
],
"macros": [
{
"macro": "{$TEST1}",
"value": "MACROTEST1"
},
{
"macro": "{$TEST2}",
"value": "MACROTEST2",
"description": "Testbeschreibung"
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"10160",
"10167"
]
},
"id": 1
}Siehe auch
Quelle
CHost::massAdd() in ui/include/classes/api/services/CHost.php.