[comment]: # ({4a6b3375-4a6b3375})
# host.massupdate

[comment]: # ({/4a6b3375-4a6b3375})

[comment]: # ({10cbc072-10cbc072})
### Beschrijving

`object host.massupdate(objectparameters)`

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

::: noteclassic
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](/manual/web_interface/frontend_sections/administration/user_roles)
voor meer informatie.
:::

[comment]: # ({/10cbc072-10cbc072})

[comment]: # ({37b8fe51-6d664071})
### 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](object#host), is de methode
accepteert de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|**hosts**<br>(vereist)|object/array|[Hosts](/manual/api/reference/host/object) moeten worden bijgewerkt.<br><br>De hosts moeten de `hostid` hebben eigenschap gedefinieerd.|
|groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) om de huidige hostgroepen te vervangen waartoe de hosts behoren.<br><br>De hostgroepen moeten de eigenschap `groupid` hebben gedefinieerd.|
|interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) om de huidige hostinterfaces op de opgegeven hosts te vervangen.|
|inventory|object|Host [inventaris](/manual/api/reference/host/object#host_inventory) eigenschappen.<br><br>Host-inventarisatiemodus kan niet worden bijgewerkt met de parameter `inventory`, gebruik in plaats daarvan `inventory_mode`. |
|macros|object/array|[Gebruikersmacro's](/manual/api/reference/usermacro/object) om de huidige gebruikersmacro's op de opgegeven hosts te vervangen.|
|templates|object/array|[Templates](/manual/api/reference/template/object) om de momenteel gekoppelde sjablonen op de opgegeven hosts te vervangen.<br><br>De sjablonen moeten de eigenschap `templateid` hebben gedefinieerd. |
|templates\_clear|object/array|[Templates](/manual/api/reference/template/object) om te ontkoppelen en te wissen van de opgegeven hosts.<br><br>De sjablonen moeten de eigenschap `templateid` hebben gedefinieerd. |

[comment]: # ({/37b8fe51-6d664071})

[comment]: # ({d166b99b-d166b99b})
### Retourwaarden

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

[comment]: # ({/d166b99b-d166b99b})

[comment]: # ({b41637d2-b41637d2})
### Voorbeelden

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({b2f0a627-4a8d8b94})
#### Meerdere hosts inschakelen

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

Verzoek:

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

Antwoord:

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

[comment]: # ({/b2f0a627-4a8d8b94})

[comment]: # ({4b09fb40-4b09fb40})
### Zie ook

- [host.update](update)
- [host.massadd](massadd)
- [host.massremove](massremove)
- [Hostgroep](/manual/api/reference/hostgroup/object#host_group)
- [Template](/manual/api/reference/template/object#host_group)
- [Gebruiker
    macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro)
-   [Gastheer
    interface](/manual/api/reference/hostinterface/object#host_interface)

[comment]: # ({/4b09fb40-4b09fb40})

[comment]: # ({ad74e98b-ad74e98b})
### Bron

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

[comment]: # ({/ad74e98b-ad74e98b})