proxy.create

Descripción

object proxy.create(object/array proxies)

Este método permite crear nuevos proxies.

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 Roles de usuario para más información.

Parámetros

(objeto/matriz) Proxies para crear.

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 del equipo que se creará para el proxy pasivo.

Requerido para proxies pasivos.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los servidores proxy creados bajo la propiedad proxyids. El orden de los ID devueltos coinciden con el orden de los proxies pasados.

Ejemplos

Crear un proxy activo

Cree un proxy de acción "Proxy activo" y asigne un equipo para que lo supervise.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "proxy.create",
           "params": {
               "host": "Active proxy",
               "status": "5",
               "hosts": [
                   {
                       "hostid": "10279"
                   }
               ]
           },
           "auth": "ab9638041ec6922cb14b07982b268f47",
           "id": 1
       }

Respuesta:

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

Crear un proxy pasivo

Cree un proxy pasivo "Proxy pasivo" y asigne dos equipos para que los supervise.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "proxy.create",
           "params": {
               "host": "Proxy pasivo",
               "status": "6",
               "interface": {
                   "ip": "127.0.0.1",
                   "dns": "",
                   "useip": "1",
                   "port": "10051"
               },
               "hosts": [
                   {
                       "hostid": "10192"
                   },
                   {
                       "hostid": "10139"
                   }
               ]
           },
           "auth": "ab9638041ec6922cb14b07982b268f47",
           "id": 1
       }

Respuesta:

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

Ver también

Fuente

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