proxy.update

Opis

object proxy.update(object/array proxies)

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

Ta metoda jest dostępna wyłącznie dla typu użytkownika Super admin. Uprawnienia do wywoływania tej metody można odebrać w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object/array) Właściwości proxy do zaktualizowania.

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

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

Parameter Type Description
hosts array Hosty, które mają być monitorowane przez proxy.
Jeśli host jest już monitorowany przez inne proxy, zostanie przypisany do bieżącego proxy.

Hosty muszą mieć zdefiniowaną wyłącznie właściwość hostid.
apm object Ustawienia monitorowania wydajności aplikacji (APM) proxy.

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.