host.massupdate
Beschreibung
object host.massupdate(object parameters)
Diese Methode ermöglicht es, verwandte Objekte gleichzeitig zu ersetzen oder zu entfernen und Eigenschaften mehrerer Hosts zu aktualisieren.
Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Berechtigungen zum Aufrufen der Methode können 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 Eigenschaften enthalten, die aktualisiert werden sollen.
Zusätzlich zu den standardmäßigen Host-Eigenschaften akzeptiert die Methode die folgenden Parameter.
| Parameter | Type | Beschreibung |
|---|---|---|
| hosts | object/array | Hosts, die aktualisiert werden sollen. Die Hosts dürfen nur die Eigenschaft hostid definiert haben.Parameterverhalten: - erforderlich |
| groups | object/array | Hostgruppen, die die aktuellen Hostgruppen ersetzen sollen, zu denen die Hosts gehören. Die Hostgruppen dürfen nur die Eigenschaft groupid definiert haben. |
| interfaces | object/array | Host-Schnittstellen, die die aktuellen Host-Schnittstellen auf den angegebenen Hosts ersetzen sollen. |
| inventory | object | Eigenschaften des Host-Inventars. Der Host-Inventarmodus kann nicht über den Parameter inventory aktualisiert werden, verwenden Sie stattdessen inventory_mode. |
| macros | object/array | Benutzer-Makros, die die aktuellen Benutzer-Makros auf den angegebenen Hosts ersetzen sollen. |
| templates | object/array | Vorlagen, die die aktuell verknüpften Vorlagen auf den angegebenen Hosts ersetzen sollen. Die Vorlagen dürfen nur die Eigenschaft templateid definiert haben. |
| templates_clear | object/array | Vorlagen, die von den angegebenen Hosts getrennt und entfernt werden sollen. Die Vorlagen dürfen nur die Eigenschaft templateid definiert haben. |
Rückgabewerte
(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Hosts
unter der Eigenschaft hostids enthält.
Beispiele
Aktivieren mehrerer Hosts
Aktivieren Sie die Überwachung von zwei Hosts, das heißt, setzen Sie ihren Status auf "0".
{
"jsonrpc": "2.0",
"method": "host.massupdate",
"params": {
"hosts": [
{
"hostid": "69665"
},
{
"hostid": "69666"
}
],
"status": 0
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"69665",
"69666"
]
},
"id": 1
}Siehe auch
Quelle
CHost::massUpdate() in ui/include/classes/api/services/CHost.php.