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.