proxy.update

Descripción

object proxy.update(object/array proxies)

Este método permite actualizar los proxies existentes.

Este método solo está disponible para el tipo de usuario Super administrador. Los permisos para activar el método se pueden revocar en la configuración de roles de usuario. Ver User roles para más información.

Parámetros

(objeto/matriz) Propiedades del proxy que se actualizarán.

La propiedad proxyid debe definirse para cada proxy; todas las demás propiedades son opcionales. Sólo las propiedades pasadas se actualizarán, todas las demás permanecerán sin cambios.

Además de las [propiedades de proxy estándar] (object#proxy), el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
hosts matriz Equipos que serán monitoreados por el proxy. Si un equipo ya está monitoreado por un proxy diferente, será reasignado al proxy actual.

Los equipos deben tener definida la propiedad hostid.
interface objeto Interfaz de equipo para reemplazar la interfaz existente para el proxy pasivo.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los servidores proxy actualizados bajo la propiedad proxyids.

Ejemplos

Cambiar equipos monitoreados por un proxy

Actualice el proxy para monitorear los dos equipos proporcionados.

Solicitud:

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

Respuesta:

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

Cambiar estado de proxy

Cambie el proxy a un proxy activo y cámbiele el nombre a "Proxy activo".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "proxy.update",
           "params": {
               "proxyid": "10293",
               "host": "Proxy activo",
               "status": "5"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

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

Ver también

Fuente

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