host.massremove

Beschreibung

object host.massremove(object parameters)

Diese Methode ermöglicht es, verknüpfte Objekte von mehreren Hosts zu entfernen.

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 entfernt werden sollen.

Parameter Type Beschreibung
hostids ID/array IDs der Hosts, die aktualisiert werden sollen.

Parameterverhalten:
- erforderlich
groupids ID/array IDs der Host-Gruppen, aus denen die angegebenen Hosts entfernt werden sollen.
interfaces object/array Host-Schnittstellen, die von den angegebenen Hosts entfernt werden sollen.

Im Host-Schnittstellenobjekt dürfen nur die Eigenschaften ip, dns und port definiert sein.
macros string/array Benutzermakros, die von den angegebenen Hosts gelöscht werden sollen.
templateids ID/array IDs der Vorlagen, deren Verknüpfung mit den angegebenen Hosts aufgehoben werden soll.
templateids_clear ID/array IDs der Vorlagen, deren Verknüpfung mit den angegebenen Hosts aufgehoben und die von ihnen entfernt werden sollen.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Hosts unter der Eigenschaft hostids enthält.

Beispiele

Verknüpfung von Vorlagen aufheben

Heben Sie die Verknüpfung einer Vorlage von zwei Hosts auf und löschen Sie alle aus der Vorlage stammenden Entitäten.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "host.massremove",
    "params": {
        "hostids": ["69665", "69666"],
        "templateids_clear": "325"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "69665",
            "69666"
        ]
    },
    "id": 1
}

Siehe auch

Quelle

CHost::massRemove() in ui/include/classes/api/services/CHost.php.