Vorlage.massupdate

Beschreibung

object template.massupdate(object parameters)

Diese Methode ermöglicht es, verwandte Objekte gleichzeitig zu ersetzen oder zu entfernen und Eigenschaften mehrerer Vorlagen zu aktualisieren.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die IDs der zu aktualisierenden Vorlagen und die Objekte enthält, die für die Vorlagen ersetzt werden sollen.

Die Methode akzeptiert die folgenden Parameter.

Parameter Typ Beschreibung
templates object/array Vorlagen, die aktualisiert werden sollen.

Die Vorlagen dürfen nur die Eigenschaft templateid enthalten.

Parameterverhalten:
- erforderlich
groups object/array Vorlagengruppen, die die aktuellen Vorlagengruppen ersetzen sollen, zu denen die Vorlagen gehören.

Die Vorlagengruppen dürfen nur die Eigenschaft groupid enthalten.
macros object/array Benutzer-Makros, die alle aktuellen Benutzer-Makros auf den angegebenen Vorlagen ersetzen sollen.
templates_clear object/array Vorlagen, die von den angegebenen Vorlagen getrennt und entfernt werden sollen.

Die Vorlagen dürfen nur die Eigenschaft templateid enthalten.
templates_link object/array Vorlagen, die die derzeit verknüpften Vorlagen ersetzen sollen.

Die Vorlagen dürfen nur die Eigenschaft templateid enthalten.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Vorlagen in der Eigenschaft templateids enthält.

Beispiele

Vorlage entkoppeln

Die Vorlage "10091" von den angegebenen Vorlagen entkoppeln und löschen.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10085"
            },
            {
                "templateid": "10086"
            }
        ],
        "templates_clear": [
            {
                "templateid": "10091"
            }
        ]
    },
    "id": 1
}

Antwort:

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

Ersetzen von Benutzermakros

Ersetzen Sie alle Benutzermakros durch das angegebene Benutzermakro in mehreren Vorlagen.

Request:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10074"
            },
            {
                "templateid": "10075"
            },
            {
                "templateid": "10076"
            },
            {
                "templateid": "10077"
            }
        ],
        "macros": [
            {
                "macro": "{$AGENT.TIMEOUT}",
                "value": "5m",
                "description": "Timeout after which agent is considered unavailable. Works only for agents reachable from Zabbix server/proxy (passive mode)."
            }
        ]
    },
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10074",
            "10075",
            "10076",
            "10077"
        ]
    },
    "id": 1
}

Siehe auch

Quelle

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