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 | Typ | Beschreibung |
|---|---|---|
| hosts | object/array | Hosts, die aktualisiert werden sollen. Die Hosts dürfen nur die Eigenschaft hostid definiert haben.Parameterverhalten: - required |
| groups | object/array | Host groups, die die aktuellen Host groups ersetzen sollen, zu denen die Hosts gehören. Die Host groups dürfen nur die Eigenschaft groupid definiert haben. |
| interfaces | object/array | Host interfaces, die die aktuellen Host interfaces auf den angegebenen Hosts ersetzen sollen. |
| inventory | object | Eigenschaften des Host inventory. Der Host inventory-Modus kann nicht über den Parameter inventory aktualisiert werden, verwenden Sie stattdessen inventory_mode. |
| macros | object/array | User macros, die die aktuellen User macros auf den angegebenen Hosts ersetzen sollen. |
| templates | object/array | Vorlagen, die die derzeit 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.