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:

  • contiver hosts que pertençam apenas a este grupo;
  • estiver marcado como interno;
  • for usado por um protótipo de host;
  • for usado em um script global;
  • 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.