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.
Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur pour plus d'informations.
Paramètres
(object/array) Eléments à créer.
En plus des propriétés d'élément standard, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| preprocessing | array | Options de prétraitement d'élément. |
| tags | array | Tags d'élément. |
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éez un élément d'agent Zabbix numérique avec 2 tags d'élément pour surveiller l'espace disque libre sur l'hôte avec l'ID "30074".
Requête :
{
"jsonrpc": "2.0",
"method": "item.create",
"params": {
"name": "Free disk space on /home/joe/",
"key_": "vfs.fs.size[/home/joe/,free]",
"hostid": "30074",
"type": 0,
"value_type": 3,
"interfaceid": "30084",
"tags": [
{
"tag": "Disc usage"
},
{
"tag": "Equipment",
"value": "Workstation"
}
],
"delay": "30s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Création d'un élément d'inventaire d'hôte
Créez un élément d'agent Zabbix pour remplir 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éez un élément à l'aide d'un multiplicateur personnalisé.
Requête :
{
"jsonrpc": "2.0",
"method": "item.create",
"params": {
"name": "Device uptime",
"key_": "sysUpTime",
"hostid": "11312",
"type": 4,
"snmp_oid": "SNMPv2-MIB::sysUpTime.0",
"value_type": 1,
"delay": "60s",
"units": "uptime",
"interfaceid": "1156",
"preprocessing": [
{
"type": 1,
"params": "0.01",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Création d'un élément dépendant
Créez un élément dépendant pour l'élément principal avec l'ID 24759. Seules les dépendances sur le même hôte sont autorisées. Par conséquent, l'élément principal 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éez un élément de méthode de requête POST avec le prétraitement de la 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",
"error_handler": 0,
"error_handler_params": ""
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 2
}Réponse :
Créer un élément de script
Créez une collection de données simple à l'aide d'un élément de script.
Requête :
{
"jsonrpc": "2.0",
"method": "item.create",
"params": {
"name": "Script example",
"key_": "custom.script.item",
"hostid": "12345",
"type": 21,
"value_type": 4,
"params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",
"parameters": [
{
"name": "host",
"value": "{HOST.CONN}"
}
],
"timeout": "6s",
"delay": "30s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 2
}Réponse :
Source
CItem::create() dans ui/include/classes/api/services/CItem.php.