Documentation
Table of Contents
item.create
Descri??o
object item.create(object/array items)
Este m¨¦todo permite criar novos itens.
Itens da Web n?o podem ser criados atrav¨¦s da API do Áú»¢¶Ä²©.
Este m¨¦todo est¨¢ dispon¨ªvel apenas para os tipos de usu¨¢rio Admin e Super admin. As permiss?es para chamar o m¨¦todo podem ser revogadas nas configura??es de fun??o do usu¨¢rio. Consulte User roles para obter mais informa??es.
Par?metros
(object/array) Itens para criar.
Al¨¦m das propriedades padr?o do item, o m¨¦todo aceita os seguintes par?metros.
| Par?metro | Tipo | Descri??o |
|---|---|---|
| preprocessing | array | Op??es preprocessing de itens. |
| tags | array | Item tags. |
Valores de retorno
(object) Retorna um objeto contendo os IDs dos itens criados na propriedade itemids. A ordem dos IDs retornados corresponde ¨¤ ordem dos itens passados.
Exemplos
Criando um item
Crie um item de agente Áú»¢¶Ä²© num¨¦rico com 2 tags de item para monitorar o espa?o livre em disco no host com o ID "30074".
Request:
{
"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": "Disc usage"
},
{
"tag": "Equipment",
"value": "Workstation"
}
],
"delay": "30s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Criando um item de invent¨¢rio do host
Crie um item de agente Áú»¢¶Ä²© para preencher o campo de invent¨¢rio "SO" do host.
Request:
{
"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
}Response:
Criando um item com pr¨¦-processamento
Criar um item usando o multiplicador personalizado.
Request:
{
"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
}Response:
Criando item dependente
Crie um item dependente para o item mestre com ID 24759. Somente depend¨ºncias no mesmo host s?o permitidas, portanto, o mestre e o item dependente devem ter o mesmo hostid
Request:
{
"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
}Response:
Criar item de agente HTTP
Criar item de m¨¦todo de solicita??o POST com pr¨¦-processamento de resposta JSON.
Request:
{
"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
}Response:
Criar item de script
Crie uma coleta de dados simples usando um item de script.
Request:
{
"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
}Response:
Fonte
CItem::create() in ui/include/classes/api/services/CItem.php.