host.massupdate

Beschrijving

object host.massupdate(objectparameters)

Met deze methode kunnen gelijktijdig gerelateerde objecten worden vervangen of verwijderd en update eigenschappen op meerdere hosts.

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 eigenschappen die moeten worden bijgewerkt.

Naast de standaard hosteigenschappen, is de methode accepteert de volgende parameters.

Parameter	Type	Beschrijving
hosts (vereist)	object/array	Hosts moeten worden bijgewerkt. De hosts moeten de `hostid` hebben eigenschap gedefinieerd.
groups	object/array	Host groups om de huidige hostgroepen te vervangen waartoe de hosts behoren. De hostgroepen moeten de eigenschap `groupid` hebben gedefinieerd.
interfaces	object/array	Host interfaces om de huidige hostinterfaces op de opgegeven hosts te vervangen.
inventory	object	Host inventaris eigenschappen. Host-inventarisatiemodus kan niet worden bijgewerkt met de parameter `inventory`, gebruik in plaats daarvan `inventory_mode`.
macros	object/array	Gebruikersmacro's om de huidige gebruikersmacro's op de opgegeven hosts te vervangen.
templates	object/array	Templates om de momenteel gekoppelde sjablonen op de opgegeven hosts te vervangen. De sjablonen moeten de eigenschap `templateid` hebben gedefinieerd.
templates_clear	object/array	Templates om te ontkoppelen en te wissen van de opgegeven hosts. 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

Meerdere hosts inschakelen

Schakel bewaking van twee hosts in, d.w.z. stel hun status in op 0.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "host.massupdate",
           "params": {
               "hosts": [
                   {
                       "hostid": "69665"
                   },
                   {
                       "hostid": "69666"
                   }
               ],
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "69665",
                   "69666"
               ]
           },
           "id": 1
       }

Zie ook

Bron

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

Documentation