host.massremove

Descrição

object host.massremove(object parameters)

Este método permite remover objetos relacionados de 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 do 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 os objetos que devem ser removidos.

Parâmetro	Tipo	Descrição
hostids	ID/array	IDs dos hosts a serem atualizados. Comportamento do parâmetro: - obrigatório
groupids	ID/array	IDs dos grupos de hosts dos quais remover os hosts fornecidos.
interfaces	object/array	Interfaces de host a serem removidas dos hosts fornecidos. O objeto de interface de host deve ter apenas as propriedades `ip`, `dns` e `port` definidas.
macros	string/array	Macros de usuário a serem excluídas dos hosts fornecidos.
templateids	ID/array	IDs dos templates a serem desvinculados dos hosts fornecidos.
templateids_clear	ID/array	IDs dos templates a serem desvinculados e limpos dos hosts fornecidos.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos hosts atualizados na propriedade hostids.

Exemplos

Desvinculando templates

Desvincule um template de dois hosts e exclua todas as entidades do template.

Requisição:

{
           "jsonrpc": "2.0",
           "method": "host.massremove",
           "params": {
               "hostids": ["69665", "69666"],
               "templateids_clear": "325"
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "69665",
                   "69666"
               ]
           },
           "id": 1
       }

Veja também

Origem

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

Documentation