item.create

Beschrijving

object item.create(object/array items)

Deze methode maakt het mogelijk om nieuwe items te maken.

Parameters

(object/array) Items die moeten worden gemaakt.

Naast de standaard itemeigenschappen, is de methode accepteert de volgende parameters.

Retourwaarden

(object) Retourneert een object dat de ID's van de gemaakte items bevat onder de eigenschap 'itemids'. De volgorde van de geretourneerde ID's komt overeen met de volgorde van de doorgegeven items.

Voorbeelden

Een item aanmaken

Maak een numeriek Zabbix-agent-item met 2 itemtags om de vrije schijfruimte op host met ID "30074" te monitoren.

Aanvraag:

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "name": "Vrije schijfruimte op /home/joe/",
        "key_": "vfs.fs.size[/home/joe/,free]",
        "hostid": "30074",
        "type": 0,
        "value_type": 3,
        "interfaceid": "30084",
        "tags": [
            {
                "tag": "Schijfgebruik"
            },
            {
                "tag": "Apparatuur",
                "value": "Werkstation"
            }
        ],
        "delay": "30s"
    },
    "id": 1
}

Antwoord:

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

Een hostinventarisitem aanmaken

Maak een Zabbix-agent-item aan om het "OS"-inventarisveld van de host te vullen.

Aanvraag:

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

Antwoord:

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

Een item met voorverwerking aanmaken

Maak een item aan met aangepaste vermenigvuldiger.

Aanvraag:

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "name": "Apparaat 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
}

Antwoord:

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

Een afhankelijk item aanmaken

Maak een afhankelijk item aan voor het hoofditem met ID 24759. Alleen afhankelijkheden op dezelfde host zijn toegestaan, daarom moeten het hoofditem en het afhankelijke item dezelfde hostid hebben.

Aanvraag:

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
      "hostid": "30074",
      "name": "Afhankelijk testitem",
      "key_": "afhankelijk.item",
      "type": 18,
      "master_itemid": "24759",
      "value_type": 2
    },
    "id": 1
}

Antwoord:

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

HTTP-agentitem aanmaken

Maak een item aan met de POST-verzoekmethode met JSON-responsoorverwerking.

Aanvraag:

{
    "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": "Voorbeeld HTTP-agent JSON",
        "value_type": 0,
        "output_format": 1,
        "preprocessing": [
            {
                "type": 12,
                "params": "$.random",
                "error_handler": 0,
                "error_handler_params": ""
            }
        ]
    },
    "id": 1
}

Antwoord:

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

Script-item aanmaken

Maak een eenvoudige gegevensverzameling aan met behulp van een script-item.

Aanvraag:

{
    "jsonrpc": "2.0",
    "method": "item.create",
    "params": {
        "name": "Script-voorbeeld",
        "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
}

Antwoord:

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

Bron

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