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

This translation is older than the original page and might be outdated. See what has changed.

Sidebar

fr:manual:api:reference:item:create

item.create

Description

object item.create(object/array items)

Cette méthode permet de créer de nouveaux éléments.

Les éléments Web ne peuvent pas être créés via l'API Zabbix.

Paramètres

(object/array) Éléments à créer.

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

Paramètre Type Description
applications array ID des applications auxquelles ajouter l'élément.
preprocessing array Options de pré-traitement des éléments.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des éléments créés sous la propriété itemids. L'ordre des ID retournés correspond à l'ordre des éléments transmis.

Exemples

Création d'un élément

Créer un élément numérique d'agent Zabbix pour surveiller l'espace disque disponible sur l'hôte portant l'ID “30074” et l'ajouter à deux applications.

Requête :

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "name": "Free disk space on $1",
        "key_": "vfs.fs.size[/home/joe/,free]",
        "hostid": "30074",
        "type": 0,
        "value_type": 3,
        "interfaceid": "30084",
        "applications": [
            "609",
            "610"
        ],
        "delay": "30s"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

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

Création d'un élément d'inventaire d'hôte

Créer un élément d'agent Zabbix pour renseigner le champ d'inventaire “Os” de l'hôte.

Requête :

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "name": "uname",
        "key_": "system.uname",
        "hostid": "30021",
        "type": 0,
        "interfaceid": "30007",
        "value_type": 1,
        "delay": "10s",
        "inventory_link": 5
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

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

Création d'un élément avec prétraitement

Créer un élément en utilisant un multiplicateur personnalisé.

Requête :

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "name": "Device uptime",
        "key_": "sysUpTime",
        "hostid": "11312",
        "type": 4,
        "snmp_community": "{$SNMP_COMMUNITY}",
        "snmp_oid": "SNMPv2-MIB::sysUpTime.0",
        "value_type": 1,
        "delay": "60s",
        "units": "uptime",
        "interfaceid": "1156",
        "preprocessing": [
            {
                "type": "1",
                "params": "0.01"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

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

Création d'élément dépendant

Créez un élément dépendant pour l'élément maître avec l'ID 24759. Seules les dépendances sur le même hôte sont autorisées. Par conséquent, le maître et l'élément dépendant doivent avoir le même hostid.

Requête :

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
      "hostid": "30074",
      "name": "Dependent test item",
      "key_": "dependent.item",
      "type": "18",
      "master_itemid": "24759",
      "value_type": "2"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

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

Créer un élément d'agent HTTP

Créer un élément de méthode de requête POST avec pré-traitement de réponse JSON.

Requête :

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "url":"http://127.0.0.1/http.php",
        "query_fields": [
            {
                "mode":"json"
            },
            {
                "min": "10"
            },
            {
                "max": "100"
            }
        ],
        "interfaceid": "1",
        "type":"19",
        "hostid":"10254",
        "delay":"5s",
        "key_":"json",
        "name":"http agent example JSON",
        "value_type":"0",
        "output_format":"1",
        "preprocessing": [
            {
                "type": "12",
                "params": "$.random"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 2
}

Réponse :

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

Source

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