- template.update
- Beschreibung
- Parameter
- Rückgabewerte
- Beispiele
- Ändern der Standard-Eigenschaften einer Vorlage
- Vorlagengruppen aktualisieren
- Aktualisieren mehrerer Vorlagengruppen
- Aktualisieren von Vorlagen-Tags
- Aktualisieren von Makros in Vorlagen
- Mehrere Vorlagenmakros aktualisieren
- Verknüpfte Vorlagen einer Vorlage aktualisieren
- Mehrere mit Vorlagen verknüpfte Vorlagen bereinigen
- Quelle
template.update
Beschreibung
object template.update(object/array templates)
Mit dieser Methode können vorhandene Vorlagen aktualisiert werden.
Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.
Parameter
(object/array) Zu aktualisierende Vorlageneigenschaften.
Die Eigenschaft templateid muss für jede Vorlage definiert sein, alle anderen
Eigenschaften sind optional. Nur die angegebenen Eigenschaften werden aktualisiert, alle
anderen bleiben unverändert.
Zusätzlich zu den Standard-Vorlageneigenschaften akzeptiert die Methode die folgenden Parameter.
| Parameter | Type | Beschreibung |
|---|---|---|
| groups | object/array | Vorlagengruppen, die die aktuellen Vorlagengruppen ersetzen, denen die Vorlagen angehören. Für die Vorlagengruppen darf nur die Eigenschaft groupid definiert sein. |
| tags | object/array | Vorlagen-Tags, die die aktuellen Vorlagen-Tags ersetzen. |
| macros | object/array | Benutzermakros, die die aktuellen Benutzermakros in den angegebenen Vorlagen ersetzen. |
| templates | object/array | Vorlagen, die die aktuell verknüpften Vorlagen ersetzen. Vorlagen, die nicht übergeben werden, werden nur getrennt. Für die Vorlagen darf nur die Eigenschaft templateid definiert sein. |
| templates_clear | object/array | Vorlagen, die von den angegebenen Vorlagen getrennt und daraus entfernt werden. Für die Vorlagen darf nur die Eigenschaft templateid definiert sein. |
Rückgabewerte
(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Vorlagen
unter der Eigenschaft templateids enthält.
Beispiele
Ändern der Standard-Eigenschaften einer Vorlage
Ändern Sie den technischen Namen der Vorlage in „Linux by Zabbix agent Custom“, den sichtbaren Namen in „My template“ und aktualisieren Sie die Beschreibung der Vorlage.
{
"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."
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Vorlagengruppen aktualisieren
Ersetzen Sie alle Vorlagengruppen für die angegebene Vorlage durch eine andere.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"groups": [
{
"groupid": "24"
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Aktualisieren mehrerer Vorlagengruppen
Ersetzen Sie alle Vorlagengruppen für mehrere Vorlagen durch andere.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": [
{
"templateid": "10086",
"groups": [
{
"groupid": "24"
}
]
},
{
"templateid": "10087",
"groups": [
{
"groupid": "1"
},
{
"groupid": "12"
}
]
},
{
"templateid": "10088",
"groups": [
{
"groupid": "1"
},
{
"groupid": "12"
}
]
}
],
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086",
"10087",
"10088"
]
},
"id": 1
}Aktualisieren von Vorlagen-Tags
Ersetzen Sie alle Vorlagen-Tags durch ein anderes.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"tags": [
{
"tag": "host-name",
"value": "{HOST.NAME}"
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Aktualisieren von Makros in Vorlagen
Ersetzen Sie alle Makros der Vorlage durch ein anderes.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"macros": [
{
"macro": "{$MY_MACRO}",
"value": "new_value"
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Mehrere Vorlagenmakros aktualisieren
Ersetzen Sie alle Benutzermakros in mehreren Vorlagen durch das angegebene Benutzermakro.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": [
{
"templateid": "10087",
"macros": [
{
"macro": "{$AGENT.TIMEOUT}",
"value": "5m",
"description": "Zeitüberschreitung, nach der der Agent als nicht verfügbar betrachtet wird. Funktioniert nur für Agents, die vom Zabbix Server/Proxy aus erreichbar sind (passiver Modus)."
}
]
},
{
"templateid": "10088",
"macros": [
{
"macro": "{$AGENT.TIMEOUT}",
"value": "5m",
"description": "Zeitüberschreitung, nach der der Agent als nicht verfügbar betrachtet wird. Funktioniert nur für Agents, die vom Zabbix Server/Proxy aus erreichbar sind (passiver Modus)."
}
]
}
],
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10087",
"10088"
]
},
"id": 1
}Verknüpfte Vorlagen einer Vorlage aktualisieren
Heben Sie die Verknüpfung aller Vorlagen von der angegebenen Vorlage auf (ohne sie zu löschen) und verknüpfen Sie stattdessen eine andere Vorlage damit.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"templates": [
{
"templateid": "10001"
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Mehrere mit Vorlagen verknüpfte Vorlagen bereinigen
Verknüpfen Sie eine bestimmte verknüpfte Vorlage von den angegebenen Vorlagen ab und bereinigen Sie sie.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": [
{
"templateid": "10087",
"templates_clear": [
{
"templateid": "10001"
}
]
},
{
"templateid": "10088",
"templates_clear": [
{
"templateid": "10001"
}
]
}
],
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10087",
"10088"
]
},
"id": 1
}Quelle
CTemplate::update() in ui/include/classes/api/services/CTemplate.php.