hostinterface.massremove

Beschreibung

object hostinterface.massremove(object parameters)

Mit dieser Methode können Sie Host-Schnittstellen von den angegebenen Hosts entfernen.

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 zu entfernenden Schnittstellen enthalten.

Parameter Typ Beschreibung
interfaces object/array Zu entfernende Host-Schnittstellen der angegebenen Hosts.

Im Host-Schnittstellenobjekt dürfen nur die Eigenschaften ip, dns und port definiert sein.

Parameterverhalten:
- erforderlich
hostids ID/array IDs der zu aktualisierenden Hosts.

Parameterverhalten:
- erforderlich

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der gelöschten Host-Schnittstellen unter der Eigenschaft interfaceids enthält.

Beispiele

Schnittstellen entfernen

Entfernen Sie die SNMP-Schnittstelle "127.0.0.1" von zwei Hosts.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.massremove",
    "params": {
        "hostids": [
            "30050",
            "30052"
        ],
        "interfaces": {
            "dns": "",
            "ip": "127.0.0.1",
            "port": "161"
        }
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "interfaceids": [
            "30069",
            "30070"
        ]
    },
    "id": 1
}

Siehe auch

Quelle

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