proxy.update

Beschrijving

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

Met deze methode kunnen bestaande proxy's worden bijgewerkt.

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-eigenschappen moeten worden bijgewerkt.

De eigenschap proxyid moet worden gedefinieerd voor elke proxy, alle andere eigenschappen zijn optioneel. Alleen de doorgegeven eigenschappen worden bijgewerkt, allemaal andere blijven ongewijzigd.

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 om de bestaande interface voor de passieve proxy te vervangen.

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte proxy's bevat onder de eigenschap proxyids.

Voorbeelden

Hosts wijzigen die worden gecontroleerd door een proxy

Werk de proxy bij om de twee opgegeven hosts te controleren.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "proxy.update",
           "params": {
               "proxyid": "10293",
               "hosts": [
                   {
                       "hostid": "10294"
                   },
                   {
                       "hostid": "10295"
                   },
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

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

Proxystatus wijzigen

Wijzig de proxy in een actieve proxy en hernoem deze naar "Actieve proxy".

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "proxy.update",
           "params": {
               "proxyid": "10293",
               "host": "Active proxy",
               "status": "5"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

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

Zie ook

Bron

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