You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

proxy.update

Descripció

object proxy.update(object/array proxies)

Aquest mètode permet actualitzar proxys.

Tenim aquest mètode disponible només per a l'usuari Super admin. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu Rols d'usuari.

Paràmetres

(object/array) Propietats del proxy per actualitzar.

La propietat proxyid s'ha d'establir per a cada proxy, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.

A més de les propietats proxy estàndard, el mètode admet els paràmetres següents.

Paràmetre Tipus Descripció
hosts array Equips per ésser monitorats pel proxy.
Si un equip ja és monitorat per un proxy diferent, es reassignarà al proxy actual.

Els equips han de tindre només la propietat hostid establerta.

Valors de retorn

(object) Retorna un objecte contingut als IDs dels proxys actualitzats sota la propietat proxyids.

Exemples

Canviar els equips monitorats per un proxy

Actualitzar el proxy per monitorar dos equips donats.

Petició:

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

Resposta:

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

Canviar l'estat del proxy

Canviar el proxy com a proxy actiu i reanomenar-lo com a "Active proxy".

Petició:

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

Resposta:

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

Afegiu un proxy a un grup de proxys

Actualitzeu el proxy amb l'identificador "5" i afegiu-lo al grup de proxys amb l'identificador "1".

Petició:

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

Resposta:

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

Veieu també

Font

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