Table of Contents
item.create
Beschrijving
object item.create(object/array items)
Deze methode maakt het mogelijk om nieuwe items aan te maken.
Webitems kunnen niet worden gemaakt via de Zabbix API.
Deze methode is alleen beschikbaar voor Admin en Super admin gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruiker rollen voor meer informatie.
Parameters
(object/array) Items die moeten worden gemaakt.
Naast de standaard itemeigenschappen, is de methode accepteert de volgende parameters.
| Parameter | Type | Beschrijving |
|---|---|---|
| preprocessing | array | Item preprocessing opties. |
| tags | array | Item tags. |
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 aan met 2 itemtags om de vrije schijfruimte op de host met ID "30074" te monitoren.
Verzoek:
{
"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
}Antwoord:
Een hostinventarisitem maken
Maak een Zabbix-agentitem om het inventarisveld "OS" van de host in te vullen.
Verzoek:
{
"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
}Antwoord:
Een item maken met voorbewerking
Maak een item met behulp van een aangepaste vermenigvuldiger.
Verzoek:
{
"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
}Antwoord:
Aanmaken afhankelijk item
Maak een afhankelijk artikel voor het hoofdartikel met ID 24759. Alleen afhankelijkheden van dezelfde host zijn toegestaan, daarom master en de afhankelijk item moet dezelfde hostid hebben.
Verzoek:
{
"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
}Antwoord:
HTTP-agentitem maken
Maak een POST-aanvraagmethode-item met JSON-responsvoorverwerking.
Verzoek:
{
"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
}Antwoord:
Scriptitem maken
Maak een eenvoudige gegevensverzameling met behulp van een scriptitem.
Verzoek:
{
"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
}Antwoord:
Bron
CItem::create() in ui/include/classes/api/services/CItem.php.