template.massupdate

Descrição

object template.massupdate(object parameters)

Este método permite substituir ou remover simultaneamente objetos relacionados e atualizar propriedades em vários 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. Consulte 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 modelos atualizados na propriedade templateids.

Exemplos

Desvinculando um template

Desvincule e limpe o template "10091" dos templates fornecidos.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10085"
            },
            {
                "templateid": "10086"
            }
        ],
        "templates_clear": [
            {
                "templateid": "10091"
            }
        ]
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10085",
            "10086"
        ]
    },
    "id": 1
}

Substituindo macros de usuário

Substitua todas as macros de usuário pela macro de usuário fornecida em vários templates.

Requisição:

{
    "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:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10074",
            "10075",
            "10076",
            "10077"
        ]
    },
    "id": 1
}

Veja também

Fonte

CTemplate::massUpdate() in ui/include/classes/api/services/CTemplate.php.