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
       }
Copy
✔ Copied

Respuesta:

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

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
       }
Copy
✔ Copied

Respuesta:

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

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
       }
Copy
✔ Copied

Respuesta:

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

Ver también

Fuente

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.