hostgroup.delete

Opis

object hostgroup.delete(array hostGroupIds)

Ta metoda umożliwia usuwanie grup hostów.

Grupa hostów nie może zostać usunięta, jeśli:

  • zawiera hosty, które należą wyłącznie do tej grupy;
  • jest oznaczona jako wewnętrzna;
  • jest używana przez prototyp hosta;
  • jest używana w skrypcie globalnym;
  • jest używana w warunku korelacji.

Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(array) ID grup hostów do usunięcia.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory usuniętych grup hostów w właściwości groupids.

Przykłady

Usuwanie wielu grup hostów

Usuń dwie grupy hostów.

Żądanie:

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

Odpowiedź:

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

Źródło

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