proxy.update

Descrizione

object proxy.update(object/array proxies)

Questo metodo consente di aggiornare 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 ogni proxy; tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, mentre 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.

Gli host devono avere definita solo la proprietà hostid.
apm object Impostazioni di Application performance monitoring (APM) del proxy.

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.