template.massupdate

Description

object template.massupdate(object parameters)

Cette méthode permet de remplacer ou de supprimer simultanément des objets liés et de mettre à jour les propriétés de plusieurs modèles.

Cette méthode est disponible uniquement pour les types d'utilisateur Admin et Super admin. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Consultez Rôles utilisateur pour plus d'informations.

Paramètres

(object) Paramètres contenant les IDs des modèles à mettre à jour et les objets à remplacer pour les modèles.

La méthode accepte les paramètres suivants.

Parameter Type Description
templates object/array Modèles à mettre à jour.

Les modèles doivent avoir uniquement la propriété templateid définie.

Comportement du paramètre:
- required
groups object/array Groupes de modèles à remplacer par les groupes de modèles actuels auxquels appartiennent les modèles.

Les groupes de modèles doivent avoir uniquement la propriété groupid définie.
macros object/array Macros utilisateur à remplacer par toutes les macros utilisateur actuelles sur les modèles donnés.
templates_clear object/array Modèles à dissocier et à vider des modèles donnés.

Les modèles doivent avoir uniquement la propriété templateid définie.
templates_link object/array Modèles à remplacer par les modèles actuellement liés.

Les modèles doivent avoir uniquement la propriété templateid définie.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des modèles mis à jour sous la propriété templateids.

Exemples

Dissociation d'un modèle

Dissocier et vider le modèle "10091" des modèles donnés.

Requête :

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

Réponse :

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

Remplacement des macros utilisateur

Remplacez toutes les macros utilisateur par la macro utilisateur donnée sur plusieurs modèles.

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
}

Voir aussi

Source

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