hostinterface.replacehostinterfaces

Beschreibung

object hostinterface.replacehostinterfaces(object parameters)

Mit dieser Methode können Sie alle Host-Schnittstellen auf einem bestimmten Host ersetzen.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die ID des zu aktualisierenden Hosts und die neuen Host-Schnittstellen enthalten.

Parameter Typ Beschreibung
interfaces object/array Host-Schnittstellen, mit denen die aktuellen Host-Schnittstellen ersetzt werden sollen.

Parameterverhalten:
- erforderlich
hostid ID ID des zu aktualisierenden Hosts.

Parameterverhalten:
- erforderlich

Rückgabewerte

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

Beispiele

Ersetzen von Host-Schnittstellen

Ersetzen Sie alle Host-Schnittstellen durch eine einzelne Agent-Schnittstelle.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.replacehostinterfaces",
    "params": {
        "hostid": "30052",
        "interfaces": {
            "dns": "",
            "ip": "127.0.0.1",
            "main": 1,
            "port": "10050",
            "type": 1,
            "useip": 1
        }
    },
    "id": 1
}

Antwort:

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

Siehe auch

Quelle

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