hostinterface.massremove

Beschreibung

object hostinterface.massremove(object parameters)

Diese Methode ermöglicht es Ihnen, Host-Schnittstellen von den angegebenen Hosts zu entfernen.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufruf der Methode kann 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 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.