proxy.create

Beschreibung

object proxy.create(object/array proxies)

Mit dieser Methode können neue Proxys erstellt werden.

Diese Methode ist nur für den Benutzertyp 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/array) Zu erstellende Proxys.

Zusätzlich zu den Standard-Proxy-Eigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Type Beschreibung
hosts array Hosts, die vom Proxy überwacht werden sollen.
Wenn ein Host bereits von einem anderen Proxy überwacht wird, wird er dem aktuellen Proxy neu zugewiesen.

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

Rückgabewerte

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

Beispiele

Einen aktiven Proxy erstellen

Erstellen Sie einen aktiven Proxy „Active proxy“ und weisen Sie ihm einen Host zur Überwachung zu.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "hosts": [
            {
                "hostid": "10279"
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "proxyids": [
            "10280"
        ]
    },
    "id": 1
}

Einen passiven Proxy erstellen

Erstellen Sie einen passiven Proxy „Passive proxy“ und weisen Sie ihm zwei Hosts zur Überwachung zu.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Passive proxy",
        "operating_mode": "1",
        "address": "127.0.0.1",
        "port": "10051",
        "hosts": [
            {
                "hostid": "10192"
            },
            {
                "hostid": "10139"
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "proxyids": [
            "10284"
        ]
    },
    "id": 1
}

Erstellen eines Proxy und Hinzufügen zu einer Proxy-Gruppe

Erstellen Sie einen aktiven Proxy „Active proxy“ und fügen Sie ihn der Proxy-Gruppe mit der ID „1“ hinzu.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "proxy_groupid": "1",
        "operating_mode": "0"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "proxyids": [
            "5"
        ]
    },
    "id": 1
}

Siehe auch

Quelle

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