hostinterface.create

Beschreibung

object hostinterface.create(object/array hostInterfaces)

Mit dieser Methode können neue Host-Schnittstellen erstellt werden.

Diese Methode ist nur für Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Benutzerrolleneinstellungen entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu erstellende Host-Schnittstellen.

Die Methode akzeptiert Host-Schnittstellen mit den Standard-Host-Schnittstelleneigenschaften.

Rückgabewerte

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

Beispiele

Eine neue Schnittstelle erstellen

Erstellen Sie eine sekundäre IP-Agent-Schnittstelle auf dem Host „30052“.

Anfrage:

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

Antwort:

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

Eine Schnittstelle mit SNMP-Details erstellen

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.create",
    "params": {
        "hostid": "10456",
        "main": "0",
        "type": "2",
        "useip": "1",
        "ip": "127.0.0.1",
        "dns": "",
        "port": "1601",
        "details": {
            "version": "2",
            "bulk": "1",
            "community": "{$SNMP_COMMUNITY}"
        }
    },
    "id": 1
}

Antwort:

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

Siehe auch

Quelle

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