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 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 hosts a serem atualizados e as 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	object/array	Hosts a serem atualizados. Os hosts devem ter apenas a propriedade `hostid` definida. Comportamento do parâmetro: - obrigatório
groups	object/array	Grupos de hosts para substituir os grupos de hosts atuais aos quais os hosts pertencem. Os grupos de hosts devem ter apenas a propriedade `groupid` definida.
interfaces	object/array	Interfaces de host para substituir as interfaces de host atuais nos hosts fornecidos.
inventory	object	Propriedades do Inventário do host. O modo de inventário do host não pode ser atualizado usando o parâmetro `inventory`, use `inventory_mode` em vez disso.
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 apenas a propriedade `templateid` definida.
templates_clear	object/array	Templates para desvincular e limpar dos hosts fornecidos. Os templates devem ter apenas a propriedade `templateid` definida.

Valores de retorno

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

Exemplos

Habilitando múltiplos hosts

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

Requisição:

{
           "jsonrpc": "2.0",
           "method": "host.massupdate",
           "params": {
               "hosts": [
                   {
                       "hostid": "69665"
                   },
                   {
                       "hostid": "69666"
                   }
               ],
               "status": 0
           },
           "id": 1
       }

Resposta:

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

Veja também

Fonte

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

Documentation