proxy.update

Descrizione

object proxy.update(object/array proxies)

Questo metodo consente di aggiornare i proxy esistenti.

Questo metodo è disponibile solo per il tipo di utente Super admin. I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Vedere Ruoli utente per ulteriori informazioni.

Parametri

(object/array) Proprietà del proxy da aggiornare.

La proprietà proxyid deve essere definita per ciascun proxy, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte le altre rimarranno invariate.

Oltre alle proprietà standard del proxy, il metodo accetta i seguenti parametri.

Parametro Tipo Descrizione
hosts array Host da monitorare tramite il proxy.
Se un host è già monitorato da un proxy diverso, verrà riassegnato al proxy corrente.

Per gli host deve essere definita solo la proprietà hostid.

Valori restituiti

(object) Restituisce un oggetto contenente gli ID dei proxy aggiornati nella proprietà proxyids.

Esempi

Modificare gli host monitorati da un proxy

Aggiorna il proxy affinché monitori i due host specificati.

Richiesta:

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

Risposta:

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

Modificare lo stato del proxy

Modificare il proxy in un proxy attivo e rinominarlo in "Active proxy".

Request:

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

Risposta:

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

Aggiungere un proxy a un gruppo di proxy

Aggiornare il proxy con ID "5" e aggiungerlo al gruppo di proxy con ID "1".

Richiesta:

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

Risposta:

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

Vedi anche

Fonte

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