hostinterface.massadd

Beschreibung

object hostinterface.massadd(object parameters)

Mit dieser Methode können Host-Schnittstellen gleichzeitig zu mehreren Hosts hinzugefügt werden.

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

Parameter

(object) Parameter, die die auf den angegebenen Hosts zu erstellenden Host-Schnittstellen enthalten.

Die Methode akzeptiert die folgenden Parameter.

Parameter Typ Beschreibung
interfaces object/array Host-Schnittstellen, die auf den angegebenen Hosts erstellt werden sollen.

Parameterverhalten:
- erforderlich
hosts object/array Hosts, die aktualisiert werden sollen.

Für die Hosts darf nur die Eigenschaft hostid definiert sein.

Parameterverhalten:
- erforderlich

Rückgabewerte

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

Beispiele

Schnittstellen erstellen

Erstellen Sie eine Schnittstelle auf zwei Hosts.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.massadd",
    "params": {
        "hosts": [
            {
                "hostid": "30050"
            },
            {
                "hostid": "30052"
            }
        ],
        "interfaces": {
            "dns": "",
            "ip": "127.0.0.1",
            "main": 0,
            "port": "10050",
            "type": 1,
            "useip": 1
        }
    },
    "id": 1
}

Antwort:

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

Siehe auch

Quelle

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