proxy.create

Beschrijving

object proxy.create(object/array proxy's)

Met deze methode kunnen nieuwe proxy's worden gemaakt.

Deze methode is alleen beschikbaar voor het gebruikerstype Superbeheerder. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zien Gebruiker rollen voor meer informatie.

Parameters

(object/array) Proxy's om te maken.

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

Parameter Type Beschrijving
hosts array Hosts die door de proxy moeten worden gecontroleerd. Als een host al door een andere proxy wordt gecontroleerd, wordt deze opnieuw toegewezen aan de huidige proxy.

De hosts moeten de eigenschap 'hostid' hebben gedefinieerd.
interface object Host interface die moet worden gemaakt voor de passieve proxy.

Vereist voor passieve proxy's.

Retourwaarden

(object) Retourneert een object dat de ID's van de gemaakte proxy's bevat onder de eigenschap proxyids. De volgorde van de geretourneerde ID's komt overeen met de volgorde van de doorgegeven volmachten.

Voorbeelden

Maak een actieve proxy

Maak een actieproxy "Actieve proxy" en wijs een host toe die moet worden bewaakt erdoor.

Verzoek:

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

Antwoord:

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

Maak een passieve proxy

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

Verzoek:

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

Antwoord:

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

Zie ook

Bron

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