vienums.create

Apraksts

object item.create(object/array items)

Šī metode ļauj izveidot jaunus vienumus.

Tīmekļa vienumus nevar izveidot, izmantojot Zabbix API.

Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Atļaujas izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

(object/array) Vienumi, ko izveidot.

Papildus standarta vienuma īpašībām metode pieņem šādus parametrus.

Parametrs Tips Apraksts
preprocessing array Vienuma priekšapstrādes opcijas.
tags array Vienuma birkas.

Atgrieztās vērtības

(object) Atgriež objektu, kas satur izveidoto vienumu ID īpašībā itemids. Atgriezto ID secība atbilst nodoto vienumu secībai.

Piemēri

Vienuma izveide

Izveidojiet skaitlisku Zabbix aģenta vienumu ar 2 vienuma tagiem, lai uzraudzītu brīvo diska vietu hostā ar ID "30074".

Pieprasījums:

{
    "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
}

Atbilde:

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

Hosts inventarizācijas vienuma izveide

Izveidojiet Zabbix aģents vienumu, lai aizpildītu hosta inventarizācijas lauku "OS".

Pieprasījums:

{
    "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
}

Atbilde:

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

Vienuma izveide ar priekšapstrādi

Izveidojiet vienumu, izmantojot pielāgotu reizinātāju.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "name": "Ierīces darbības laiks",
        "key_": "sysUpTime",
        "hostid": "10084",
        "type": 20,
        "snmp_oid": "SNMPv2-MIB::sysUpTime.0",
        "value_type": 1,
        "delay": "60s",
        "interfaceid": "83",
        "preprocessing": [
            {
                "type": 1,
                "params": "0.01",
                "error_handler": 1,
                "error_handler_params": ""
            }
        ]
    },
    "id": 1
}

Atbilde:

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

Atkarīgā vienuma izveide

Izveidojiet atkarīgo vienumu galvenajam vienumam ar ID 24759. Ir atļautas tikai atkarības uz tā paša hosta, tādēļ galvenajam un atkarīgajam vienumam jābūt ar vienādu hostid.

Pieprasījums:

{
    "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
}

Atbilde:

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

Izveidot HTTP aģenta vienumu

Izveidojiet POST pieprasījuma metodes vienumu ar JSON atbildes priekšapstrādi.

Pieprasījums:

{
    "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
}

Atbilde:

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

Izveidot skripta vienumu

Izveidojiet vienkāršu datu vākšanu, izmantojot skripta vienumu.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "name": "Skripta piemērs",
        "key_": "custom.script.item",
        "hostid": "12345",
        "type": 21,
        "value_type": 4,
        "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));",
        "parameters": [
            {
                "name": "host",
                "value": "{HOST.CONN}"
            }
        ],
        "timeout": "6s",
        "delay": "30s"
    },
    "id": 1
}

Atbilde:

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

Avots

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