[comment]: # ({c572a02a-c572a02a})
# host.update

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

[comment]: # ({a740c7d4-12e31652})
### Beschrijving

`object host.update(object/array hosts)`

Deze methode maakt het mogelijk om bestaande hosts bij te werken.

::: noteclassic
Deze methode is alleen beschikbaar voor gebruikerstypes *Admin* en *Superadmin*. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van gebruikersrollen. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles) voor meer informatie.
:::

[comment]: # ({/a740c7d4-12e31652})

[comment]: # ({6727520a-3a8eac6a})
### Parameters

`(object/array)` Hosteigenschappen die moeten worden bijgewerkt.

De eigenschap `hostid` moet worden gedefinieerd voor elke host, alle andere
eigenschappen zijn optioneel. Alleen de opgegeven eigenschappen worden bijgewerkt, allemaal
andere blijven ongewijzigd.

Houd er echter rekening mee dat het bijwerken van de technische naam van de host ook wordt bijgewerkt
de zichtbare naam van de host (indien niet gegeven of leeg) door de technische van de host
naam waarde.

Naast de [standaard hosteigenschappen](object#host), is de methode
accepteert de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|groups|object/array|Host [groepen](/manual/api/reference/hostgroup/object#host_group) om de huidige hostgroepen waartoe de host behoort te vervangen.<br><br>De hostgroepen moeten de `groupid hebben ` eigenschap gedefinieerd. Alle hostgroepen die niet in het verzoek worden vermeld, worden ontkoppeld.|
|interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) om de huidige hostinterfaces te vervangen.<br><br>Alle interfaces die niet in het verzoek worden vermeld, worden verwijderd.|
|tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag) om de huidige hosttags te vervangen.<br><br>Alle tags die niet in het verzoek worden vermeld, worden verwijderd .|
|inventaris|object|Host [inventaris](/manual/api/reference/host/object#host_inventory) eigenschappen.|
|macros|object/array|[Gebruikersmacro's](/manual/api/reference/usermacro/object) om de huidige gebruikersmacro's te vervangen.<br><br>Alle macro's die niet in het verzoek worden vermeld, worden verwijderd.|
|templates|object/array|[Templates](/manual/api/reference/template/object) om de momenteel gekoppelde sjablonen te vervangen. Alle sjablonen die niet in de aanvraag worden vermeld, worden alleen ontkoppeld.<br><br>Voor de sjablonen moet de eigenschap `templateid` zijn gedefinieerd.|
|templates\_clear|object/array|[Templates](/manual/api/reference/template/object) om te ontkoppelen en te wissen van de host.<br><br>Voor de sjablonen moet de eigenschap `templateid` zijn gedefinieerd.|

::: notitietip
In tegenstelling tot de Zabbix-frontend, wanneer `naam` (zichtbaar
hostnaam) is hetzelfde als `host` (technische hostnaam), bijwerken van `host`
via API zal `naam` niet automatisch updaten. Beide eigenschappen moeten zijn
expliciet bijgewerkt.
:::

[comment]: # ({/6727520a-3a8eac6a})

[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]: # ({bcd7b728-ce50c453})
#### Host inschakelen

Activeer de monitoring voor de host, dat wil zeggen, stel de status ervan in op "0".

[Aanvraag](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "status": 0
    },
    "id": 1
}
```

Retourwaarde:

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

[comment]: # ({/bcd7b728-ce50c453})

[comment]: # ({56f46465-bea1db7e})
#### Templates ontkoppelen

Ontkoppel en verwijder twee sjablonen van de host.

[Aanvraag](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "templates_clear": [
            {
                "templateid": "10124"
            },
            {
                "templateid": "10125"
            }
        ]
    },
    "id": 1
}
```

Retourwaarde:

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

[comment]: # ({/56f46465-bea1db7e})

[comment]: # ({b789e636-98dcfd68})
#### Hostmacro's bijwerken

Vervang alle hostmacro's door twee nieuwe.

[Aanvraag](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "macros": [
            {
                "macro": "{$PASS}",
                "value": "wachtwoord"
            },
            {
                "macro": "{$DISC}",
                "value": "sda",
                "description": "Bijgewerkte beschrijving"
            }
        ]
    },
    "id": 1
}
```

Antwoord:

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

[comment]: # ({/b789e636-98dcfd68})

[comment]: # ({72eb8ecc-da99f3b8})
#### Hostinventaris bijwerken

Wijzig inventarisatiemodus en voeg locatie toe

[Aanvraag](/handleiding/api#uitvoeren-van-aanvragen):

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "inventory_mode": 0,
        "inventory": {
            "location": "Letland, Riga"
        }
    },
    "id": 1
}
```

Antwoord:

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

[comment]: # ({/72eb8ecc-da99f3b8})

[comment]: # ({4a11868e-5cc5d950})
#### Hosttags bijwerken

Vervang alle hosttags door een nieuwe.

[Aanvraag](/handleiding/api#uitvoeren-van-aanvragen):

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "tags": {
            "tag": "OS",
            "value": "RHEL 7"
        }
    },
    "id": 1
}
```

Antwoord:

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

[comment]: # ({/4a11868e-5cc5d950})

[comment]: # ({58eba4cd-ae2d89bf})
#### Bijwerken van ontdekte hostmacro's

Zet de door de ontdekkingsregel gecreëerde macro "automatisch" om naar "handmatig" en verander de waarde ervan naar "nieuwe-waarde".

[Aanvraag](/handleiding/api#uitvoeren-van-aanvragen):

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "macros": {
            "hostmacroid": "5541",
            "value": "nieuwe-waarde",
            "automatic": "0"
        }
    },
    "id": 1
}
```

Antwoord:

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

[comment]: # ({/58eba4cd-ae2d89bf})

[comment]: # ({1948c7c9-b4a9cd46})
#### Hostversleuteling bijwerken

Werk de host "10590" bij om alleen PSK-versleuteling te gebruiken voor verbindingen van host naar Zabbix-server, en verander de PSK-identiteit en PSK-sleutel.
Let op dat de host [vooraf geconfigureerd moet zijn om PSK te gebruiken](/handleiding/versleuteling/psk_gebruiken#psk-configuratie-voorbeeld-voor-server-agent-communicatie).

[Aanvraag](/handleiding/api#uitvoeren-van-aanvragen):

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10590",
        "tls_connect": 1,
        "tls_accept": 2,
        "tls_psk_identity": "PSK 002",
        "tls_psk": "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"
    },
    "id": 1
}
```

Antwoord:

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

[comment]: # ({/1948c7c9-b4a9cd46})

[comment]: # ({29f34c97-23501347})
### Zie ook

-   [host.massadd](massadd)
-   [host.massupdate](massupdate)
-   [host.massremove](massremove)
-   [Hostgroep](/handleiding/api/referentie/hostgroup/object#host_groep)
-   [Sjabloon](/handleiding/api/referentie/template/object#sjabloon)
-   [Gebruikersmacro](/handleiding/api/referentie/usermacro/object#hostsjabloon_niveau_macro)
-   [Hostinterface](/handlemanualiding/api/referentie/hostinterface/object#host_interface)
-   [Hostinventaris](object#host_inventaris)
-   [Hosttag](object#host_tag)

[comment]: # ({/29f34c97-23501347})

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

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

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