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
       }
Copy
✔ Copied

Resposta:

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

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
       }
Copy
✔ Copied

Resposta:

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

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
       }
Copy
✔ Copied

Resposta:

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

Veieu també

Font

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.