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. 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 ID des zu aktualisierenden Host und die neuen Host-Schnittstellen enthalten.

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

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

Parameterverhalten:
- erforderlich

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der erstellten Host-Schnittstellen in 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.