Documentation
Table of Contents
imagen.crear
Descripción
object item.create(object/array items)
Este método permite crear nuevos elementos.
Los elementos web no se pueden crear a través de la API de Zabbix.
Este método solo está disponible para tipos de usuarios Administrador y Superadministrador tipos de usuarios. Los permisos para activar el método se pueden revocar en el rol de ajustes de usuario. Ver User roles para más información.
Parámetros
(object/array) Items a crear.
Además de las standard item properties, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| preprocesamiento | matriz | Opciones de item preprocessing. |
| etiquetas | matriz | Item tags. |
Valores de retorno
(object) Devuelve un objeto que contiene los IDs de los items creados bajo la propiedad "itemids". El orden de los IDs devueltos coincide con el orden de los items pasados.
Ejemplos
Creando una métrica
Cree una métrica numérica de Agente Zabbix con 2 etiquetas de métrica para monitorear el espacio libre en disco en el equipo con ID "30074".
Solicitud:
{
"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": "Disk usage"
},
{
"tag": "Equipment",
"value": "Workstation"
}
],
"delay": "30s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta:
Creando un item de inventario de host
Cree un item de Zabbix agent item para completar el campo de inventario "OS".
Solicitud:
{
"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
}Respuesta:
Creando un item con preprocesamiento
Cree an item usando un multiplicador personalizado.
Solicitud:
{
"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
}Respuesta:
Creando item dependiente
Cree un item dependiente para el item master con ID 24759. Sólo se permiten dependencias en el mismo host, por lo tanto, master y el el elemento dependiente debe tener el mismo ID de host.
Solicitud:
{
"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
}Respuesta:
Crear item de agente HTTP
Cree un item de método de solicitud POST con preprocesamiento de respuesta JSON.
Solicitud:
{
"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
}Respuesta:
Crear item de secuencia de comandos
Cree una colección de datos simple utilizando de un item de secuencia de comandos.
Solicitud:
{
"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
}Respuesta:
Fuente
CItem::create() en ui/include/classes/api/services/CItem.php.