host.massadd

Beschrijving

object host.massadd(objectparameters)

Deze methode maakt het mogelijk om tegelijkertijd meerdere gerelateerde objecten aan alles toe te voegen de opgegeven gastheren.

Deze methode is alleen beschikbaar voor Admin en Super admin gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruiker rollen voor meer informatie.

Parameters

(object) Parameters die de ID's van de te bijwerken hosts en de objecten om aan alle hosts toe te voegen bevatten.

De methode accepteert de volgende parameters.

Parameter	Type	Beschrijving
hosts	object/array	Te bijwerken hosts. De hosts moeten de eigenschap `hostid` gedefinieerd hebben. Gedrag van parameter: - verplicht
groups	object/array	Hostgroepen om aan de opgegeven hosts toe te voegen. De hostgroepen moeten de eigenschap `groupid` gedefinieerd hebben.
interfaces	object/array	Te creëren host-interfaces voor de opgegeven hosts.
macros	object/array	Te creëren gebruikersmacro's voor de opgegeven hosts.
templates	object/array	Sjablonen om aan de opgegeven hosts te koppelen. De sjablonen moeten de eigenschap `templateid` gedefinieerd hebben.

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte hosts bevat onder de eigenschap hostids.

Voorbeelden

Macro's toevoegen

Voeg twee nieuwe macro's toe aan twee hosts.

Verzoek:

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

Antwoord:

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

Zie ook

Bron

CHost::create() in ui/include/classes/api/services/CHost.php.

Documentation