This is a translation of the original English documentation page. Help us make it better.

hostgroup.massupdate

Beschrijving

object hostgroup.massupdate(object parameters)

Deze methode maakt het mogelijk om hosts en sjablonen te vervangen door de gespecificeerde in meerdere hostgroepen.

Deze methode is alleen beschikbaar voor gebruikerstypen Admin en Superadmin. Toestemming om de methode te gebruiken kan worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruikersrollen voor meer informatie.

Parameters

(object) Parameters die de IDs bevatten van de te updaten hostgroepen en de objecten die moeten worden bijgewerkt.

Parameter Type Beschrijving
groups object/array Hostgroepen die moeten worden bijgewerkt.

De hostgroepen moeten de eigenschap groupid gedefinieerd hebben.

Gedrag van de parameter:
- vereist
hosts object/array Hosts die de huidige hosts in de opgegeven hostgroepen moeten vervangen.
Alle andere hosts, behalve de genoemde, worden uit de hostgroepen uitgesloten.
Ontdekte hosts worden niet beïnvloed.

De hosts moeten de eigenschap hostid gedefinieerd hebben.

Gedrag van de parameter:
- vereist

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte host bevat groepen onder de eigenschap groupids.

Voorbeelden

Hosts vervangen in een hostgroep

Vervang alle hosts in een hostgroep door de genoemde hosts.

Aanvraag:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.massupdate",
           "params": {
               "groups": [
                   {
                       "groupid": "6"
                   }
               ],
               "hosts": [
                   {
                       "hostid": "30050"
                   }
               ]
           },
           "id": 1
       }

Reactie:

{
           "jsonrpc": "2.0",
           "result": {
               "groupids": [
                   "6",
               ]
           },
           "id": 1
       }

Zie ook

Bron

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