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
       }

Creating a proxy and adding it to a proxy group

Create an active proxy "Active proxy" and add it to proxy group with ID "1".

Request:

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

Response:

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

Ver también

Fuente

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

Documentation