proxy.create

Opis

object proxy.create(object/array proxies)

Ta metoda umożliwia tworzenie nowych proxy.

Ta metoda jest dostępna tylko dla użytkownika typu Super admin. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji znajduje się w Rolach użytkowników.

Parametry

(object/array) Proxy do utworzenia.

Oprócz standardowych właściwości proxy, metoda akceptuje następujące parametry.

Parametr Typ Opis
hosts array Hosty, które mają być monitorowane przez proxy.
Jeśli host jest już monitorowany przez inny proxy, zostanie przypisany ponownie do bieżącego proxy.

Hosty muszą mieć zdefiniowaną wyłącznie właściwość hostid.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory utworzonych proxy we właściwości proxyids. Kolejność zwróconych identyfikatorów odpowiada kolejności przekazanych proxy.

Przykłady

Utwórz aktywny proxy

Utwórz aktywny proxy „Active proxy” i przypisz do niego host do monitorowania.

Żądanie:

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

Odpowiedź:

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

Utwórz pasywny proxy

Utwórz pasywny proxy „Passive proxy” i przypisz do niego dwa hosty do monitorowania.

Żądanie:

{
    "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
}

Odpowiedź:

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

Tworzenie proxy i dodawanie go do grupy proxy

Utwórz aktywny proxy „Active proxy” i dodaj go do grupy proxy o ID „1”.

Żądanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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