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:

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

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:

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

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:

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

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:

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

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:

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

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:

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

Fuente

CItem::create() en ui/include/classes/api/services/CItem.php.