Documentation
Table of Contents
item.create
Descripció
object item.create(object/array items)
Aquest mètode permet crear nous elements.
Els elements Web no es poden crear emprant l'API Zabbix.
Tenim aquest mètode disponible només per als usuaris Admin i Super admin. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu Rols d'usuari.
Paràmetres
(object/array) Elements per crear.
A més de les propietats d'element estàndard, el mètode admet els paràmetres següents.
| Paràmetre | Tipus | Descripció |
|---|---|---|
| preprocessing | array | Opcions de preprocessament de l'element. |
| tags | array | Etiquetes de l'element. |
Valors de retorn
(object) Retorna un objecte amb els IDs dels elements creats segons la propietat itemids. L'ordre dels IDs retornats correspon a l'ordre dels elements donats.
Exemples
Crear un element
Crear un element d'agent Zabbix numèric amb dues etiquetes d'element per monitorar l'espai en disc lliure de l'equip amb ID "30074".
{ "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": "component", "value": "storage" }, { "tag": "equipment", "value": "workstation" } ], "delay": "30s" }, "id": 1 }Resposta:
Crear un element d'inventari d'equip
Crea un element d'agent Zabbix per emplenar el camp d'inventari "OS" de l'equip.
{ "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 }, "id": 1 }Resposta:
Crear un element nou amb preprocessament
Crear un element emprant un multiplicador a mida.
{ "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": "" } ] }, "id": 1 }Resposta:
Crear un element dependent
Crea un element dependent per l'element principal amb ID 24759. Només es permeten les dependències sobre el mateix equip. Per tant, l'element principal i l'element dependent hauran de tindre el mateix hostid.
{ "jsonrpc": "2.0", "method": "item.create", "params": { "hostid": "30074", "name": "Dependent test item", "key_": "dependent.item", "type": 18, "master_itemid": "24759", "value_type": 2 }, "id": 1 }Resposta:
Crear un element d'agent HTTP
Crea un element de mètode de petició POST amb el pretractament de la resposta JSON.
{ "jsonrpc": "2.0", "method": "item.create", "params": { "url":"http://127.0.0.1/http.php", "query_fields": [ { "name": "mode", "value": "json" }, { "name": "min", "value": "10" }, { "name": "max", "value": "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": "" } ] }, "id": 1 }Resposta:
Crear un element d'script
Crea una col·lecció senzilla e dades emprant un element d'script.
{ "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" }, "id": 2 }Resposta:
Font
CItem::create() in ui/include/classes/api/services/CItem.php.