host.massupdate

Descrição

object host.massupdate(object parameters)

Este método permite substituir ou remover simultaneamente objetos relacionados e atualizar propriedades em vários hosts.

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 Usuário funções Para maiores informações.

Parâmetros

Parâmetros (object) contendo os IDs dos hosts a serem atualizados e o propriedades que devem ser atualizadas.

Além das propriedades padrão do host, o método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
hosts
(obrigatório)		 object/array Hosts a serem atualizados.

Os hosts devem ter o hostid propriedade definida.
grupos objeto/array Host grupos para substituir os grupos de hosts atuais aos quais os hosts pertencem.

Os grupos de hosts devem ter a propriedade groupid definido.
interfaces object/array Host interfaces para substituir as interfaces de host atuais nos hosts fornecidos.
inventory object Host inventory propriedades.

O modo de inventário do host não pode ser atualizado usando o parâmetro inventory, use inventory_mode.
macros object/array Macros de usuário para substituir as macros de usuário atuais nos hosts fornecidos.
templates object/array Templates para substituir os templates atualmente vinculados nos hosts fornecidos.

Os templates devem ter a propriedade templateid definida.
templates_clear object/array Templates para desvincular e limpar dos hosts fornecidos.

Os templates devem ter a propriedade templateid definida.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos hosts atualizados sob a propriedade hostids.

Exemplos

Habilitando vários hosts

Habilite o monitoramento de dois hosts, ou seja, defina seu status como 0.

Solicitação:

{
    "jsonrpc": "2.0",
    "método": "host.massupdate",
    "parâmetros": {
        "anfitriões": [
            {
                "hostid": "69665"
            },
            {
                "hostid": "69666"
            }
        ],
        "estado": 0
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "resultado": {
        "hostids": [
            "69665",
            "69666"
        ]
    },
    "id": 1
}

Veja também

Fonte

CHost::massUpdate() em ui/include/classes/api/services/CHost.php.