Sidebar

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.