Table of Contents
template.update
Beschrijving
object template.update(object/array-sjablonen)
Met deze methode kunnen bestaande sjablonen 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) Sjablooneigenschappen moeten worden bijgewerkt.
De eigenschap templateid moet worden gedefinieerd voor elke sjabloon, alle andere eigenschappen zijn optioneel. Alleen de opgegeven eigenschappen worden bijgewerkt, allemaal andere blijven ongewijzigd.
Naast de standaard sjablooneigenschappen, is de methode accepteert de volgende parameters.
| Parameter | Type | Beschrijving |
|---|---|---|
| groups | object/array | Host groups om de huidige hostgroepen te vervangen waartoe de sjablonen behoren. De hostgroepen moeten de eigenschap groupid hebben gedefinieerd. |
| tags | object/array | Template tags om de huidige template-tags te vervangen. |
| macros | object/array | Gebruikersmacro's om de huidige gebruikersmacro's op de gegeven sjablonen te vervangen. |
| templates | object/array | Templates om de momenteel gekoppelde sjablonen te vervangen. Sjablonen die niet worden doorgegeven, worden alleen ontkoppeld. Voor de sjablonen moet de eigenschap templateid zijn gedefinieerd. |
| templates_clear | object/array | Templates om te ontkoppelen en te wissen uit de gegeven sjablonen. De sjablonen moeten de eigenschap templateid hebben gedefinieerd. |
Retourwaarden
(object) Retourneert een object dat de ID's van de bijgewerkte sjablonen bevat onder de eigenschap templateids.
Voorbeelden
Changing the standard template properties
Change the technical name of the template to "Linux by Zabbix agent Custom", the visible name to "My template", and update the template description.
Request:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"host": "Linux by Zabbix agent Custom",
"name": "My template",
"description": "This is a custom Linux template."
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Updating template groups
Replace all template groups for the given template with a different one.
Request:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"groups": [
{
"groupid": "24"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Updating template tags
Replace all template tags with a different one.
Request:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"tags": [
{
"tag": "Host name",
"value": "{HOST.NAME}"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Updating template macros
Replace all template macros with a different one.
Request:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"macros": [
{
"macro": "{$MY_MACRO}",
"value": "new_value"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Updating template linked templates
Unlink (without clearing) all templates from the given template and link a different one to it.
Request:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"templates": [
{
"templateid": "10087"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Clearing template linked templates
Unlink and clear the given template from a specific linked template.
Request:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"templates_clear": [
{
"templateid": "10087"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Bron
CTemplate::update() in ui/include/classes/api/services/CTemplate.php.