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.

Anfrage:

{
    "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.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "groups": [
            {
                "groupid": "24"
            } 
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}

Aktualisieren von Vorlagen-Tags

Ersetzen Sie alle Vorlagen-Tags durch ein anderes.

Anfrage:

{
    "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.

Anfrage:

{
    "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
}

Aktualisieren verknüpfter Vorlagen

Trennen Sie die Verknüpfung aller Vorlagen von der angegebenen Vorlage, ohne sie zu löschen, und verknüpfen Sie eine andere Vorlage damit.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "templates": [
            {
                "templateid": "10087"
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}

Vorlage verknüpfte Vorlagen bereinigen

Die angegebene Vorlage von einer bestimmten verknüpften Vorlage trennen und bereinigen.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "templates_clear": [
            {
                "templateid": "10087"
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}

Quelle

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