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. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere Ruoli utente.

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.

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

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
}

Creazione di un proxy con crittografia basata su certificato

Creare un proxy attivo con crittografia basata su certificato. Il proxy è configurato per monitorare l'host "10785".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "hosts": [
            {
                "hostid": "10785"
            }
        ],
        "tls_accept": "4",
        "tls_issuer": "CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com",
        "tls_subject": "CN=Zabbix server,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com"
    },
    "id": 1
}

Risposta:

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

Creazione di un proxy con APM abilitato

Creare un proxy attivo "Active proxy" con APM abilitato.
Il proxy accetta fino a 1000 messaggi al secondo, aggiunge l'attributo della risorsa deployment.environment alle tracce e aggiunge l'attributo della risorsa cloud.region alle metriche.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "apm": {
            "data_collection_status": "1",
            "max_messages_per_second": "1000",
            "additional_resource_attributes": [
                {
                    "key": "deployment.environment",
                    "value": "production",
                    "signal_type": "0"
                },
                {
                    "key": "cloud.region",
                    "value": "eu-central-1",
                    "signal_type": "1"
                }
            ]
        }
    },
    "id": 1
}

Risposta:

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

Vedi anche

Fonte

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