proxy.update

Opis

object proxy.update(object/array proxies)

Ta metoda umożliwia aktualizację istniejących proxy.

Ta metoda jest dostępna tylko dla użytkowników 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) Właściwości proxy do zaktualizowania.

Właściwość proxyid musi być zdefiniowana dla każdego proxy, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

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

Parametr Typ Opis
hosts array Hosty do monitorowania przez proxy.
Jeśli host jest już monitorowany przez inny proxy, zostanie ponownie przypisany do bieżącego proxy.

Dla hostów musi być zdefiniowana tylko właściwość hostid.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych proxy we właściwości proxyids.

Przykłady

Zmień hosty monitorowane przez proxy

Zaktualizuj proxy, aby monitorował dwa podane hosty.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "proxy.update",
    "params": {
        "proxyid": "10293",
        "hosts": [
            {
                "hostid": "10294"
            },
            {
                "hostid": "10295"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

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

Zmień status proxy

Zmień proxy na aktywny proxy i zmień jego nazwę na „Active proxy”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "proxy.update",
    "params": {
        "proxyid": "10293",
        "name": "Active proxy",
        "operating_mode": "0"
    },
    "id": 1
}

Odpowiedź:

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

Dodawanie proxy do grupy proxy

Zaktualizuj proxy o ID „5” i dodaj go do grupy proxy o ID „1”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "proxyid": "5",
        "proxy_groupid": "1",
        "local_address": "127.0.0.1"
    },
    "id": 1
}

Odpowiedź:

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

Zobacz także

Źródło

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