hostgroup.massupdate

Descrição

object hostgroup.massupdate(object parameters)

Este método permite substituir hosts e templates pelos especificados em vários grupos de 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 do usuário. Veja Funções de usuário para mais informações.

Parâmetros

(object) Parâmetros contendo os IDs dos grupos de hosts a serem atualizados e os objetos que devem ser atualizados.

Parâmetro	Tipo	Descrição
groups	object/array	Grupos de hosts a serem atualizados. Os grupos de hosts devem ter apenas a propriedade `groupid` definida. Comportamento do parâmetro: - obrigatório
hosts	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. Hosts descobertos não serão afetados. Os hosts devem ter apenas a propriedade `hostid` definida. Comportamento do parâmetro: - obrigatório

Valores de retorno

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

Exemplos

Substituindo hosts em um grupo de hosts

Substitua todos os hosts em um grupo de hosts pelos hosts mencionados.

Requisição:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.massupdate",
           "params": {
               "groups": [
                   {
                       "groupid": "6"
                   }
               ],
               "hosts": [
                   {
                       "hostid": "30050"
                   }
               ]
           },
           "id": 1
       }

Resposta:

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

Veja também

Fonte

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

Documentation