Documentation

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.

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

• host.update
• host.massadd
• host.massremove
• Grupo de hosts
• Modelo
• Do utilizador macro
• Hospedeiro interface

Fonte

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