host.massupdate

Opis

object host.massupdate(object parameters)

Ta metoda umożliwia jednoczesne zastępowanie lub usuwanie powiązanych obiektów oraz aktualizowanie właściwości wielu hostów.

Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywoływania tej metody można odebrać 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 aktualizacji oraz właściwości, które powinny zostać zaktualizowane.

Oprócz standardowych właściwości hosta, metoda przyjmuje następujące parametry.

Parameter Type Description
hosts object/array Hosty do aktualizacji.

Hosty muszą mieć zdefiniowaną wyłącznie właściwość hostid.

Zachowanie parametru:
- required
groups object/array Grupy hostów do zastąpienia bieżących grup hostów, do których należą hosty.

Grupy hostów muszą mieć zdefiniowaną wyłącznie właściwość groupid.
interfaces object/array Interfejsy hosta do zastąpienia bieżących interfejsów hosta na podanych hostach.
inventory object Właściwości inwentarza hosta.

Trybu inwentarza hosta nie można zaktualizować za pomocą parametru inventory; zamiast tego użyj inventory_mode.
macros object/array Makra użytkownika do zastąpienia bieżących makr użytkownika na podanych hostach.
templates object/array Szablony do zastąpienia aktualnie powiązanych szablonów na podanych hostach.

Szablony muszą mieć zdefiniowaną wyłącznie właściwość templateid.
templates_clear object/array Szablony do odłączenia i usunięcia z podanych hostów.

Szablony muszą mieć zdefiniowaną wyłącznie właściwość templateid.

Zwracane wartości

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

Przykłady

Włączanie wielu hostów

Włącz monitorowanie dwóch hostów, tj. ustaw ich status na 0.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "host.massupdate",
    "params": {
        "hosts": [
            {
                "hostid": "69665"
            },
            {
                "hostid": "69666"
            }
        ],
        "status": 0
    },
    "id": 1
}

Odpowiedż:

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

Zobacz także

Źródło

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