proxy.create

Beschrijving

object proxy.create(object/array proxies)

Deze methode maakt het mogelijk om nieuwe proxies te maken.

Deze methode is alleen beschikbaar voor gebruikerstype Superadmin. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van gebruikersrollen. Zie Gebruikersrollen voor meer informatie.

Parameters

(object/array) Te creëren proxies.

Naast de standaard proxy eigenschappen, accepteert de methode de volgende parameters.

Parameter	Type	Beschrijving
hosts	array	Hosts die door de proxy moeten worden bewaakt. Als een host al door een andere proxy wordt bewaakt, wordt deze opnieuw toegewezen aan de huidige proxy. De hosts moeten de eigenschap `hostid` gedefinieerd hebben.
interface	object	Host interface die moet worden gemaakt voor de passieve proxy. Gedrag van parameter: - vereist als `status` van het Proxy object is ingesteld op "passive proxy"

Retourwaarden

(object) Geeft een object terug met de ID's van de aangemaakte proxies onder de eigenschap proxyids. De volgorde van de teruggegeven ID's komt overeen met de volgorde van de doorgegeven proxies.

Voorbeelden

Een actieve proxy creëren

Creëer een actieproxy "Actieve proxy" en wijs er een host aan toe om door deze proxy te worden bewaakt.

Aanvraag:

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

Reactie:

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

Een passieve proxy creëren

Creëer een passieve proxy "Passieve proxy" en wijs twee hosts toe om door deze proxy te worden bewaakt.

Aanvraag:

{
           "jsonrpc": "2.0",
           "method": "proxy.create",
           "params": {
               "host": "Passieve proxy",
               "status": "6",
               "interface": {
                   "ip": "127.0.0.1",
                   "dns": "",
                   "useip": "1",
                   "port": "10051"
               },
               "hosts": [
                   {
                       "hostid": "10192"
                   },
                   {
                       "hostid": "10139"
                   }
               ]
           },
           "id": 1
       }

Reactie:

{
           "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
       }

Zie ook

Bron

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

Documentation