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 met de ID's van de hosts die moeten worden bijgewerkt en de objecten toe te voegen aan alle hosts.

De methode accepteert de volgende parameters.

Parameter	Type	Beschrijving
hosts (vereist)	object/array	Hosts die moeten worden bijgewerkt. De hosts moeten de eigenschap `hostid` hebben gedefinieerd.
groups	object/array	Hostgroepen die aan de opgegeven hosts moeten worden toegevoegd. De hostgroepen moeten de eigenschap `groupid` hebben gedefinieerd.
interfaces	object/array	Host-interfaces die moeten worden gemaakt voor de opgegeven hosts.
macros	object/array	Gebruikersmacro's die moeten worden gemaakt voor de opgegeven hosts.
templates	object/array	Sjablonen om naar de opgegeven hosts te linken. De sjablonen moeten de eigenschap `templateid` hebben gedefinieerd.

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"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "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