host.massupdate

Opis

object host.massupdate(object parameters)

Ta metoda umożliwia jednoczesne zastąpienie lub usunięcie powiązanych obiektów oraz aktualizację właściwości wielu hostów.

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

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.