Documentation
Table of Contents
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 :
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 :
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 :
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 :
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 :
Source
CItem::create() dans frontends/php/include/classes/api/services/CItem.php.