host.massremove

Opis

object host.massremove(object parameters)

Ta metoda umożliwia usunięcie powiązanych obiektów z wielu hostów.

Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin. Uprawnienia do wywołania metody mogą zostać odebrane w ustawieniach ról użytkownika. Zobacz Role użytkownika po więcej informacji.

Parametry

(object) Parametry zawierające identyfikatory hostów do aktualizacji oraz obiekty, które powinny zostać usunięte.

Parametr	Typ	Opis
hostids (wymagane)	string/array	ID hostów, które mają zostać zaktualizowane.
groupids	string/array	Grupy hostów, z których mają zostać usunięte podane hosty.
interfaces	object/array	Interfejsy hostów do usunięcia z podanych hostów. Obiekt interfejsu hosta musi mieć zdefiniowane właściwości `ip`, `dns` oraz `port`.
macros	string/array	Makra użytkownika do usunięcia z podanych hostów.
templateids	string/array	Szablony do odłączenia od podanych hostów.
templateids_clear	string/array	Szablony do odłączenia i wyczyszczenia z podanych hostów.

Zwracane wartości

(object) Zwraca obiekt zawierający ID zaktualizowanych hostów w właściwości hostids.

Przykłady

Odłączanie szablonów

Odłącz szablon od dwóch hostów i usuń wszystkie powiązane z nim elementy szablonu.

Zapytanie:

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

Odpowiedź:

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

Zobacz też

Źródło

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

Documentation