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 host a serem atualizados e os objetos que devem ser atualizados.

Parâmetro	Tipo	Descrição
groups	object/array	Grupos de host a serem atualizados. Os grupos de host 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 host fornecidos. Todos os outros hosts, exceto os mencionados, serão excluídos dos grupos de host. 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 dos grupos de hosts atualizados na 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