Table of Contents
proxy.update
Descripción
object proxy.update(object/array proxies)
Este método permite actualizar proxies existentes.
Este método solo está disponible para el tipo de usuario Super admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener más información.
Parámetros
(objeto/array) Propiedades del proxy que se actualizarán.
La propiedad proxyid debe definirse para cada proxy, todas las demás propiedades son opcionales. Solo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.
Además de las propiedades estándar del proxy, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| hosts | array | Equipos que serán monitorizados por el proxy. Si un equipo ya está monitorizado por un proxy diferente, será reasignado al proxy actual. Los equipos deben tener definida únicamente la propiedad hostid. |
Valores de retorno
(object) Devuelve un objeto que contiene los IDs de los proxies actualizados bajo la propiedad proxyids.
Ejemplos
Cambiar los equipos monitorizados por un proxy
Actualice el proxy para monitorizar los dos equipos indicados.
{
"jsonrpc": "2.0",
"method": "proxy.update",
"params": {
"proxyid": "10293",
"hosts": [
{
"hostid": "10294"
},
{
"hostid": "10295"
}
]
},
"id": 1
}Respuesta:
Cambiar el estado del proxy
Cambiar el proxy a un proxy activo y renombrarlo a "Active proxy".
{
"jsonrpc": "2.0",
"method": "proxy.update",
"params": {
"proxyid": "10293",
"name": "Active proxy",
"operating_mode": "0"
},
"id": 1
}Respuesta:
Añadir un proxy a un grupo de proxies
Actualizar el proxy con ID "5" y añadirlo al grupo de proxies con ID "1".
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"proxyid": "5",
"proxy_groupid": "1",
"local_address": "127.0.0.1"
},
"id": 1
}Respuesta:
Véase también
Origen
CProxy::update() en ui/include/classes/api/services/CProxy.php.