Zabbix Documentation 4.0

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


Sidebar

fr:manual:api:reference:item:update

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.

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 de l'objet élément standard, la méthode accepte les paramètres suivants.

Paramètre Type Description
applications array ID des applications en remplacement des applications actuelles.
preprocessing array Options de pré-traitement des éléments en remplacement des options de pré-traitement actuelles.

Valeurs retournées

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

Exemples

Activation d'un élément

Activer un élément, c’est-à-dire, définir son statut à “0”.

Requête :

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

Réponse :

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

Mise à jour d'un élément dépendant

Mettre à jour le nom de l'élément dépendant et l'ID d'élément maître. Seules les dépendances sur le même hôte sont autorisées. Par conséquent, les éléments maîtres et dépendants 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"
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

Réponse :

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

Mise à jour d'un élément d'agent HTTP

Activer le trapping de la valeur de l'élément.

Requête :

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

Réponse :

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

Source

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