proxy.create

Descrizione

object proxy.create(object/array proxies)

Questo metodo consente di creare nuovi proxy.

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 User roles per ulteriori informazioni.

Parametri

(object/array) Proxy da creare.

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.

Restituisce i valori

"(object)" Restituisce un oggetto contenente gli ID dei proxy creati nella proprietà "proxyids". L'ordine del gli ID restituiti corrispondono all'ordine dei proxy passati.

Esempi

Creare un proxy attivo

Creare un proxy di azione "Active proxy" e assegnargli un host da monitorare.

Request:

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

Risposta:

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

Creare un proxy passivo

Creare un proxy passivo "Passive proxy" e assegnargli due host da monitorare.

Richiesta:

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

Risposta:

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

Creazione di un proxy e aggiunta a un gruppo di proxy

Creare un proxy attivo "Active proxy" e aggiungerlo al gruppo di proxy con ID "1".

Richiesta:

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

Risposta:

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

Vedi anche

Fonte

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