proxy.create

Description

object proxy.create(object/array proxies)

This method allows to create new proxies.

This method is only available to Super admin user type. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object/array) Proxies to create.

Additionally to the standard proxy properties, the method accepts the following parameters.

Parameter	Type	Description
hosts	array	Hosts to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy. The hosts must have the `hostid` property defined.
interface	object	Host interface to be created for the passive proxy. Required for passive proxies.

Valori di ritorno

(object) Restituisce un oggetto contenente gli ID dei proxy creati sotto la proprietà proxyids. L'ordine degli ID restituiti corrisponde all' ordine dei proxy passati.

Esempi

Create an active proxy

Create an action proxy "Active proxy" and assign a host to be monitored by it.

Request:

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

Response:

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

Create a passive proxy

Create a passive proxy "Passive proxy" and assign two hosts to be monitored by it.