Table of Contents
item.update
Descri??o
object item.update(object/array items)
Este m¨¦todo permite atualizar itens existentes.
Itens da web n?o podem ser atualizados atrav¨¦s da API Áú»¢¶Ä²©.
Este m¨¦todo est¨¢ dispon¨ªvel apenas para Admin e Superadministrador tipos de usu¨¢rio. As permiss?es para chamar o m¨¦todo podem ser revogadas na fun??o de usu¨¢rio defini??es. Veja ±«²õ³Ü¨¢°ù¾±´Ç fun??es Para maiores informa??es.
Par?metros
(object/array) Propriedades do item a serem atualizadas.
A propriedade itemid deve ser definida para cada item, todos os outros propriedades s?o opcionais. Apenas as propriedades passadas ser?o atualizadas, todas outros permanecer?o inalterados.
Al¨¦m das propriedades padr?o do item, o m¨¦todo aceita os seguintes par?metros.
|Par?metro|Tipo|Descri??o| |---------|----------------------------------- ------------|-----------| |preprocessing|array|Pr¨¦-processamento de item op??es para substituir as op??es de pr¨¦-processamento atuais.| |tags|array|Item tags.|
Valores de retorno
(object) Retorna um objeto contendo os IDs dos itens atualizados sob a propriedade itemids.
Exemplos
Habilitando um item
Habilite um item, ou seja, defina seu status como "0".
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "item.atualiza??o",
"par?metros": {
"itemid": "10092",
"estado": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Resposta:
Atualizar item dependente
Atualize o nome do item dependente e o ID do item mestre. Apenas depend¨ºncias do mesmo host s?o permitidos, portanto, o item Mestre e Dependente deve ter o mesmo hostid.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "item.atualiza??o",
"par?metros": {
"name": "Nome atualizado do item dependente",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Resposta:
Atualizar item do agente HTTP
Ative a captura de valor do item.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "item.atualiza??o",
"par?metros": {
"itemid": "23856",
"allow_traps": "1"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Resposta:
Atualizando um item com pr¨¦-processamento
Atualizar um item com a regra de pr¨¦-processamento de item "No intervalo".
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "item.atualiza??o",
"par?metros": {
"itemid": "23856",
&±ç³Ü´Ç³Ù;±è°ù¨¦-±è°ù´Ç³¦±ð²õ²õ²¹²Ô»å´Ç&±ç³Ü´Ç³Ù;: [
{
"tipo": "13",
"params": "\n100",
"error_handler": "1",
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Resposta:
Atualizando um item de script
Atualize um item de script com um script diferente e remova itens desnecess¨¢rios par?metros que foram usados pelo script anterior.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "item.atualiza??o",
"par?metros": {
"itemid": "23865",
"par?metros": [],
"script": "Áú»¢¶Ä²©.Log(3, 'Teste de log');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Resposta:
Fonte
CItem::update() em ui/include/classes/api/services/CItem.php.