Documentation
Table of Contents
itemprototype.update
Descrição
object itemprototype.update(object/array itemPrototypes)
Este método permite atualizar protótipos de itens existentes.
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. See User roles para obter mais informações.
Parâmetros
(object/array) Propriedades do protótipo do item a serem atualizadas.
A propriedade itemid deve ser definida para cada protótipo de item, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.
Além das propriedades de protótipo de item padrão, o método aceita os seguintes parâmetros.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| preprocessing | array | Protótipo de item preprocessing opções para substituir as opções de pré-processamento atuais. |
| tags | array | Protótipo de item tags. |
Valores de retorno
(object) Retorna um objeto contendo os IDs dos protótipos de itens atualizados na propriedade itemids.
Exemplos
Alterando a interface de um protótipo de item
Altere a interface do host que será usada pelos itens descobertos.
Request:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "27428",
"interfaceid": "132"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Atualizar protótipo de item dependente
Atualize o protótipo de item dependente com o novo ID de protótipo de item mestre. Apenas dependências no mesmo host (regra de modelo/descoberta) são permitidas, portanto, o item mestre e dependente deve ter o mesmo hostid e ruleid.
Request:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"master_itemid": "25570",
"itemid": "189030"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
Atualizar protótipo de item do agente HTTP
Altere os campos de consulta e remova todos os cabeçalhos personalizados.
Request:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid":"28305",
"query_fields": [
{
"random": "qwertyuiopasdfghjklzxcvbnm"
}
],
"headers": []
}
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
Atualizando opções de pré-processamento de itens
Atualizar um protótipo de item com a regra de pré-processamento de item “Custom multiplier”.
Request:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "44211",
"preprocessing": [
{
"type": 1,
"params": "4",
"error_handler": 2,
"error_handler_params": "5"
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
Atualizando um protótipo de item de script
Atualize um protótipo de item de script com um script diferente e remova parâmetros desnecessários que foram usados pelo script anterior.
Request:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
Fonte
CItemPrototype::update() in ui/include/classes/api/services/CItemPrototype.php.