hostinterface.replacehostinterfaces

Beschreibung

object hostinterface.replacehostinterfaces(object parameters)

Diese Methode ermöglicht es, alle Host-Schnittstellen auf einem angegebenen Host zu ersetzen.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle widerrufen 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.