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.
(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. |
(object)
Retourneert een object dat de ID's van de bijgewerkte host bevat prototypes onder de eigenschap hostids
.
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:
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:
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:
CHostPrototype::update() in ui/include/classes/api/services/CHostPrototype.php.