Table of Contents
template.massupdate
Descrição
object template.massupdate(object parameters)
Este método permite substituir ou remover simultaneamente objetos relacionados e atualizar propriedades em múltiplos templates.
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 de usuário. Veja Funções de usuário para mais informações.
Parâmetros
(object) Parâmetros contendo os IDs dos templates a serem atualizados e os objetos a serem substituídos nos templates.
O método aceita os seguintes parâmetros.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| templates | object/array | Templates a serem atualizados. Os templates devem ter apenas a propriedade templateid definida.Comportamento do parâmetro: - obrigatório |
| groups | object/array | Grupos de templates para substituir os grupos de templates atuais aos quais os templates pertencem. Os grupos de templates devem ter apenas a propriedade groupid definida. |
| macros | object/array | Macros de usuário para substituir todas as macros de usuário atuais nos templates fornecidos. |
| templates_clear | object/array | Templates para desvincular e limpar dos templates fornecidos. Os templates devem ter apenas a propriedade templateid definida. |
| templates_link | object/array | Templates para substituir os templates atualmente vinculados. Os templates devem ter apenas a propriedade templateid definida. |
Valores de retorno
(object) Retorna um objeto contendo os IDs dos templates atualizados na propriedade templateids.
Exemplos
Desvinculando um template
Desvincule e limpe o template "10091" dos templates fornecidos.
{
"jsonrpc": "2.0",
"method": "template.massupdate",
"params": {
"templates": [
{
"templateid": "10085"
},
{
"templateid": "10086"
}
],
"templates_clear": [
{
"templateid": "10091"
}
]
},
"id": 1
}Resposta:
Substituindo macros de usuário
Substitua todas as macros de usuário pela macro de usuário fornecida em vários templates.
{
"jsonrpc": "2.0",
"method": "template.massupdate",
"params": {
"templates": [
{
"templateid": "10074"
},
{
"templateid": "10075"
},
{
"templateid": "10076"
},
{
"templateid": "10077"
}
],
"macros": [
{
"macro": "{$AGENT.TIMEOUT}",
"value": "5m",
"description": "Timeout após o qual o agent é considerado indisponível. Funciona apenas para agents acessíveis a partir do Zabbix server/proxy (modo passivo)."
}
]
},
"id": 1
}Resposta:
Veja também
Fonte
CTemplate::massUpdate() em ui/include/classes/api/services/CTemplate.php.