Table of Contents
创建
说明
object item.create(object/array items)
此方法允许创建监控项。
WEB 监控项不能通过Zabbix API创建。
参数
(object/array) 要创建的监控项。
另外见standard item properties，此方法接受如下参数。
| 属性 类 | 说明 | |
|---|---|---|
| applications | array | 要添加到监控项的应用IDs。 |
| preprocessing | array | 监控项预处理选项。 |
返回值
(object) 在itemids属性下返回包含已创建的监控项的对象的IDs。返回的IDs的顺序与传递的监控项的IDs的顺序一致。
示例
创建一个监控项
创建一个数字类型的Zabbix agent监控项监控ID为"30074"的主机的可用磁盘空间并添加到2个应用["609", "610"]。
请求:
{
"jsonrpc": "2.0",
"method": "item.create",
"params": {
"name": "Free disk space on $1",
"key_": "vfs.fs.size[/home/joe/,free]",
"hostid": "30074",
"type": 0,
"value_type": 3,
"interfaceid": "30084",
"applications": [
"609",
"610"
],
"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
}响应:
来源
CItem::create() in frontends/php/include/classes/api/services/CItem.php.