host.massadd
Beschreibung
object host.massadd(object parameters)
Diese Methode ermöglicht es Ihnen, mehrere zusammengehörige Objekte gleichzeitig zu allen angegebenen Hosts 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 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.