hostgroup.delete

Opis

object hostgroup.delete(array hostGroupIds)

Ta metoda umożliwia usuwanie grupy hostów.

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

  • zawiera hosty należące tylko 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 metody można odebrać w ustawieniach roli użytkownika. Zobacz Role użytkownika aby uzyskać więcej informacji.

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.

Zapytanie:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.delete",
    "params": [
        "107824",
        "107825"
    ],
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "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.