proxy.create

Descripción

object proxy.create(object/array proxies)

Este método permite crear nuevos proxy.

Este método solo está disponible para el tipo de usuario Super administrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Consulte Roles de usuario para obtener 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.

Comportamiento de parámetros:
- obligatorio si el estado de objeto proxy está configurado en "proxy pasivo"

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"
                   }
               ]
           },
           "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"
                   }
               ]
           },
           "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.