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 należy zaktualizować.

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

Parametr	Typ	Opis
hosts (wymagane)	object/array	Hosty do aktualizacji. Hosty muszą mieć zdefiniowaną właściwość `hostid`.
groups	object/array	Grupy hostów do zastąpienia aktualnych grup hostów, do których należą hosty. Grupy hostów muszą mieć zdefiniowaną właściwość `groupid`.
interfaces	object/array	Interfejsy hostów do zastąpienia aktualnych interfejsów hostów w podanych hostach.
inventory	object	Właściwości inwentarza hosta. Trybu inwentarza hosta nie można aktualizować za pomocą parametru `inventory`, zamiast tego należy użyć `inventory_mode`.
macros	object/array	Makra użytkownika do zastąpienia aktualnych makr użytkownika na podanych hostach.
templates	object/array	Szablony do zastąpienia obecnie powiązanych szablonów na podanych hostach. Szablony muszą mieć zdefiniowaną właściwość `templateid`.
templates_clear	object/array	Szablony do odłączenia i wyczyszczenia z podanych hostów. Szablony muszą mieć zdefiniowaną 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.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "host.massupdate",
           "params": {
               "hosts": [
                   {
                       "hostid": "69665"
                   },
                   {
                       "hostid": "69666"
                   }
               ],
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "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.

Documentation