hostprototype.update

Beschrijving

object hostprototype.update(object/array hostPrototypes)

Met deze methode kunnen bestaande host-prototypes worden bijgewerkt.

Deze methode is alleen beschikbaar voor Admin en Super admin gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruiker rollen voor meer informatie.

Parameters

(object/array) Eigenschappen host-prototype moeten worden bijgewerkt.

De eigenschap hostid moet worden gedefinieerd voor elk host-prototype, alle andere eigenschappen zijn optioneel. Alleen de doorgegeven eigenschappen worden bijgewerkt, allemaal andere blijven ongewijzigd.

Naast het standaard host-prototype eigenschappen, accepteert de methode het volgende: parameters.

Parameter Type Beschrijving
groupLinks array Groep links om de huidige groepslinks op het host-prototype te vervangen.
groupPrototypes array Groep prototypes om de bestaande groepsprototypes op het hostprototype te vervangen.
macros object/array Gebruikersmacro's om de huidige gebruikersmacro's te vervangen.

Alle macro's die niet in het verzoek worden vermeld, worden verwijderd.
tags object/array Host prototype tags om de huidige tags te vervangen.

Alle tags die niet in het verzoek worden vermeld, worden verwijderd .
interfaces object/array Host-prototype aangepaste interfaces om de huidige interfaces te vervangen.

Aangepast interface-object moet al zijn parameters bevatten.<br >Alle interfaces die niet in het verzoek worden vermeld, worden verwijderd.
templates object/array Templates om de momenteel gekoppelde templates te vervangen.

Voor de templates moet de eigenschap templateid gedefinieerd zijn.

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte host bevat prototypes onder de eigenschap hostids.

Voorbeelden

Een host-prototype uitschakelen

Schakel een host-prototype uit, dat wil zeggen, stel de status in op 1.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "hostprototype.update",
           "params": {
               "hostid": "10092",
               "status": 1
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10092"
               ]
           },
           "id": 1
       }

Host-prototype-tags bijwerken

Vervang host-prototype-tags door nieuwe.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "hostprototype.update",
           "params": {
               "hostid": "10092",
               "tags": [
                   {
                       "tag": "Datacenter",
                       "value": "{#DATACENTER.NAME}"
                   },
                   {
                       "tag": "Instance type",
                       "value": "{#INSTANCE_TYPE}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10092"
               ]
           },
           "id": 1
       }

Aangepaste interfaces van hostprototype bijwerken

Vervang geërfde interfaces door aangepaste host-prototype-interfaces.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "hostprototype.update",
           "params": {
               "hostid": "10092",
               "custom_interfaces": "1",
               "interfaces": [
                   {
                       "main": "1",
                       "type": "2",
                       "useip": "1",
                       "ip": "127.0.0.1",
                       "dns": "",
                       "port": "161",
                       "details": {
                           "version": "2",
                           "bulk": "1",
                           "community": "{$SNMP_COMMUNITY}"
                       }
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10092"
               ]
           },
           "id": 1
       }

Zie ook

Bron

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