hostgroup.delete

Descrição

object hostgroup.delete(array hostGroupIds)

Este método permite excluir grupos de hosts.

Um grupo de hosts não pode ser excluído se:

  • ele contiver hosts que pertençam somente a esse grupo;
  • ele estiver marcado como interno;
  • ele for usado por um protótipo de host;
  • ele for usado em um script global;
  • ele for usado em uma condição de correlação.

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 de usuário. Consulte Funções de usuário para obter mais informações.

Parâmetros

(array) IDs dos grupos de hosts a serem excluídos.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos grupos de host excluídos na propriedade groupids.

Exemplos

Excluindo múltiplos grupos de hosts

Exclua dois grupos de hosts.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.delete",
    "params": [
        "107824",
        "107825"
    ],
    "id": 1
}

Resposta:

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

Origem

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