Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

hostgroup.massupdate

Descrição

object hostgroup.massupdate(object parameters)

Este método permite substituir hosts e templates pelos especificados aqueles em vários grupos de 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 grupos de hosts a serem atualizados e os objetos que devem ser atualizados.

|Parâmetro|Tipo|Descrição| |---------|----------------------------------- ------------|-----------| |grupos
(obrigatório)|objeto/array|Grupos de hosts a serem atualizados.

Os grupos de hosts devem ter a propriedade groupid definida.| |hosts
(obrigatório)|object/array|Hosts para substituir os hosts atuais nos grupos de hosts fornecidos.
Todos os outros hosts, exceto os mencionados, serão excluídos dos grupos de hosts.
>Os hosts descobertos não serão afetados.

Os hosts devem ter a propriedade hostid definida.| |modelos
(obrigatório)|objeto/array|Modelos para substituir os modelos atuais nos grupos de hosts especificados.
Todos os outros modelos, exceto os mencionados, serão excluídos dos grupos de hosts.
>
Os templates devem ter a propriedade templateid definida.|

Valores de retorno

(object) Retorna um objeto contendo os IDs do host atualizado grupos sob a propriedade groupids.

Exemplos

Substituindo hosts e modelos em um grupo de hosts

Substitua todos os hosts em um grupo de hosts pelos hosts mencionados e desvincule todos modelos do grupo de hosts.

Solicitação:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.massupdate",
           "parâmetros": {
               "grupos": [
                   {
                       "groupid": "6"
                   }
               ],
               "anfitriões": [
                   {
                       "hostid": "30050"
                   }
               ],
               "modelos": []
           },
           "auth": "f223adf833b2bf2ff38574a67bba6372",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "groupids": [
                   "6",
               ]
           },
           "id": 1
       }

Veja também

Fonte

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