Table of Contents
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:
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:
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:
Zie ook
Bron
CHostPrototype::update() in ui/include/classes/api/services/CHostPrototype.php.