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 a crear.

Además de las propiedades de proxy estándar, 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.

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": {
               "name": "Proxy activo",
               "operating_mode": "0",
               "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": {
               "name": "Proxy pasivo",
               "operating_mode": "1",
               "address": "127.0.0.1",
               "port": "10051",
               "hosts": [
                   {
                       "hostid": "10192"
                   },
                   {
                       "hostid": "10139"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Crear un proxy y agregarlo a un grupo de proxy

Cree un proxy activo "Proxy activo" y agréguelo al grupo de proxy con ID "1".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "proxy.create",
           "params": {
               "name": "Active proxy",
               "proxy_groupid": "1",
               "operating_mode": "0"
           },
           "id": 1
       }

Respuesta:

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

Ver también

Fuente

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