host.massupdate

Beschreibung

object host.massupdate(object parameters)

Mit dieser Methode können Sie gleichzeitig zugehörige Objekte ersetzen oder entfernen und Eigenschaften auf mehreren Hosts aktualisieren.

Diese Methode ist nur für die 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 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".

Anfrage:

{
    "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.