item.update

Description

object item.update(object/array items)

Cette méthode permet de mettre à jour des éléments existants.

Les éléments web ne peuvent pas être mis à jour via l'API Zabbix.

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

Paramètres

(object/array) Propriétés de l’élément à mettre à jour.

La propriété itemid doit être définie pour chaque élément, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

En plus des propriétés standard de l’élément, la méthode accepte les paramètres suivants.

Paramètre Type Description
preprocessing array Options de prétraitement de l’élément pour remplacer les options de prétraitement actuelles.

Comportement du paramètre:
- lecture seule pour les objets hérités ou les objets découverts
tags array Tags de l’élément.

Comportement du paramètre:
- lecture seule pour les objets découverts

Valeurs retournées

(object) Retourne un objet contenant les identifiants des éléments mis à jour sous la propriété itemids.

Exemples

Activation d’un élément

Activez un élément, c’est-à-dire définissez son statut sur « 0 ».

Requête:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "10092",
        "status": 0
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "10092"
        ]
    },
    "id": 1
}

Mettre à jour un élément dépendant

Mettez à jour le nom de l’élément dépendant et l’ID de l’élément maître. Seules les dépendances sur le même hôte sont autorisées, par conséquent l’élément maître et l’élément dépendant doivent avoir le même hostid.

Requête:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "name": "Dependent item updated name",
        "master_itemid": "25562",
        "itemid": "189019"
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "189019"
        ]
    },
    "id": 1
}

Mettre à jour un élément d’agent HTTP

Activer l’interception des valeurs de l’élément.

Requête:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "allow_traps": 1
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23856"
        ]
    },
    "id": 1
}

Mise à jour d’un élément avec le prétraitement

Mettez à jour un élément avec la règle de prétraitement d’élément « In range ».

Requête :

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "preprocessing": [
            {
                "type": 13,
                "params": "\n100",
                "error_handler": 1,
                "error_handler_params": ""
            }
        ]
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23856"
        ]
    },
    "id": 1
}

Mise à jour d’un élément de script

Mettez à jour un élément de script avec un script différent et supprimez les paramètres inutiles qui étaient utilisés par le script précédent.

Requête :

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23865",
        "parameters": [],
        "params": "Zabbix.log(3, 'Log test');\nreturn 1;"
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23865"
        ]
    },
    "id": 1
}

Source

CItem::update() dans ui/include/classes/api/services/CItem.php.