Documentation

Table of Contents

host.massupdate

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. Veja 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 sob a 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.