host.massremove

Opis

object host.massremove(object parameters)

Ta metoda umożliwia usuwanie 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ływania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object) Parametry zawierające identyfikatory hostów do zaktualizowania oraz obiekty, które należy usunąć.

Parametr Typ Opis
hostids ID/array Identyfikatory hostów, które mają zostać zaktualizowane.

Zachowanie parametru:
- wymagany
groupids ID/array Identyfikatory grup hostów, z których należy usunąć podane hosty.
interfaces object/array Interfejsy hosta do usunięcia z podanych hostów.

Obiekt interfejsu hosta musi mieć zdefiniowane tylko właściwości ip, dns i port.
macros string/array Makra użytkownika do usunięcia z podanych hostów.
templateids ID/array Identyfikatory szablonów, które należy odłączyć od podanych hostów.
templateids_clear ID/array Identyfikatory szablonów, które należy odłączyć i wyczyścić z podanych hostów.

Zwracane wartości

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

Przykłady

Odłączanie szablonów

Odłącz szablon od dwóch hostów i usuń wszystkie encje pochodzące z szablonu.

Żądanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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