创建
说明
object item.create(object/array items)
此方法用于创建新监控项。
无法通过 Zabbix API 创建 Web 监控项。
此方法仅允许 Admin（管理员） 和 Super admin（超级管理员） 类型的用户使用。调用此方法的权限可以在用户角色设置中撤销。更多信息请参阅 用户角色 。
参数
(object/array) 创建目标监控项。
除了 标准监控项属性 之外，此方法同样适用以下参数。
返回值
(object) 返回一个对象，该对象包含 itemids 属性下创建的监控项的 ID。返回 ID 的顺序与传递监控项的顺序一致。
示例
创建监控项
创建一个数值类型的Zabbix agent监控项，并附带2个监控项标签，用于监控ID为"30074"的主机上的空闲磁盘空间。
请求:
{
"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
}响应:
创建主机资产监控项
创建 Zabbix agent 监控项，用于增添主机的 “OS” 资产字段。
请求：
{
"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
}响应：
创建预处理监控项
创建自定义乘数监控项。
请求：
{
"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
}响应：
创建依赖监控项
创建 ID 为 24759 的主监控项的依赖监控项。仅允许依赖于同一主机，主项和依赖项要具有相同的hostid。
请求：
{
"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
}响应：
创建 HTTP agent 监控项
创建 JSON 响应预处理式的 POST 请求方法监控项。
请求：
{
"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"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 2
}响应：
创建脚本监控项
创建用于简单数据收集的脚本监控项。
请求：
{
"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
}响应：
源码
ui/include/classes/api/services/CItem.php - CItem::create()