host.massadd

Opis

object host.massadd(object parameters)

Ta metoda pozwala jednocześnie dodać wiele powiązanych obiektów do wszystkich podanych hostów.

Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin.Uprawnienia do wywoływania metody można odebrać w ustawieniach ról użytkownika.Zobacz Role użytkowników po więcej informacji.

Parametry

(object) Parametry zawierające ID hostów do zaktualizowania oraz obiekty do dodania do wszystkich hostów.

Metoda akceptuje następujące parametry.

Parametr	Typ	Opis
hosts (wymagane)	object/array	Hosty do zaktualizowania. Hosty muszą mieć zdefiniowaną właściwość `hostid`.
groups	object/array	Grupy hostów do dodania do podanych hostów. Grupy hostów muszą mieć zdefiniowaną właściwość `groupid`.
interfaces	object/array	Interfejsy hostów, które mają być utworzone dla podanych hostów.
macros	object/array	Makra użytkownika do utworzenia dla podanych hostów.
templates	object/array	Szablony do powiązania z podanymi hostami. 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

Dodawanie makr

Dodaj dwa nowe makra do dwóch hostów.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "host.massadd",
           "params": {
               "hosts": [
                   {
                       "hostid": "10160"
                   },
                   {
                       "hostid": "10167"
                   }
               ],
               "macros": [
                   {
                       "macro": "{$TEST1}",
                       "value": "MACROTEST1"
                   },
                   {
                       "macro": "{$TEST2}",
                       "value": "MACROTEST2",
                       "description": "Test description"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowiedź:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10160",
                   "10167"
               ]
           },
           "id": 1
       }

Zobacz także

Źródło

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

Documentation