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

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

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

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

Cette méthode permet de mettre à jour des hôtes existants.

::: noteclassic
Cette méthode est disponible uniquement pour les types d’utilisateur *Admin* et *Super admin*.
Les autorisations permettant d’appeler cette méthode peuvent être révoquées dans les paramètres du rôle utilisateur.
Voir [User
roles](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d’informations.
:::

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

[comment]: # ({7c7a9b0d-3a8eac6a})
### Paramètres

`(object/array)` Propriétés de l'hôte à mettre à jour.

La propriété `hostid` doit être définie pour chaque hôte, toutes les autres
propriétés sont facultatives. Seules les propriétés fournies seront mises à jour, toutes
les autres resteront inchangées.

Notez toutefois que la mise à jour du nom technique de l'hôte mettra également à jour
le nom visible de l'hôte (s'il n'est pas fourni séparément) avec la valeur
du nom technique de l'hôte.

En plus des [propriétés standard de l'hôte](object#host), la méthode
accepte les paramètres suivants.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|groups|object/array|[Groupes d'hôtes](/manual/api/reference/hostgroup/object#host-group) pour remplacer les groupes d'hôtes actuels auxquels l'hôte appartient.<br>Tous les groupes d'hôtes qui ne sont pas listés dans la requête seront dissociés.<br><br>Les groupes d'hôtes doivent avoir uniquement la propriété `groupid` définie.|
|interfaces|object/array|[Interfaces de l'hôte](/manual/api/reference/hostinterface/object) pour remplacer les interfaces actuelles de l'hôte.<br>Toutes les interfaces qui ne sont pas listées dans la requête seront supprimées.|
|tags|object/array|[Tags de l'hôte](/manual/api/reference/host/object#host-tag) pour remplacer les tags actuels de l'hôte.<br>Tous les tags qui ne sont pas listés dans la requête seront supprimés.|
|inventory|object|Propriétés de l'[inventaire de l'hôte](/manual/api/reference/host/object#host-inventory).|
|macros|object/array|[Macros utilisateur](/manual/api/reference/usermacro/object) pour remplacer les macros utilisateur actuelles.<br>Toutes les macros qui ne sont pas listées dans la requête seront supprimées.|
|templates|object/array|[Modèles](/manual/api/reference/template/object) pour remplacer les modèles actuellement liés.<br>Tous les modèles qui ne sont pas listés dans la requête seront uniquement dissociés.<br><br>Les modèles doivent avoir uniquement la propriété `templateid` définie.|
|templates\_clear|object/array|[Modèles](/manual/api/reference/template/object) à dissocier et supprimer de l'hôte.<br><br>Les modèles doivent avoir uniquement la propriété `templateid` définie.|

[comment]: # ({/7c7a9b0d-3a8eac6a})

[comment]: # ({d166b99b-d166b99b})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des hôtes mis à jour sous la propriété `hostids`.

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

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

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

[comment]: # ({bcd7b728-ce50c453})
#### Activation d’un hôte

Activez la surveillance de l’hôte, c’est-à-dire définissez son statut sur « 0 ».

[Requête](/manual/api#performing-requests):

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

Réponse :

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

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

[comment]: # ({56f46465-bea1db7e})
#### Dissociation des modèles

Dissociez et effacez deux modèles de l'hôte.

[Requête](/manual/api#performing-requests):

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

Réponse :

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

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

[comment]: # ({b789e636-98dcfd68})
#### Mise à jour des macros d'hôte

Remplacez toutes les macros d'hôte par deux nouvelles.

[Requête](/manual/api#performing-requests) :

```json
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "macros": [
            {
                "macro": "{$PASS}",
                "value": "password"
            },
            {
                "macro": "{$DISC}",
                "value": "sda",
                "description": "Description mise à jour"
            }
        ]
    },
    "id": 1
}
```

Réponse :

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

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

[comment]: # ({72eb8ecc-da99f3b8})
#### Mise à jour de l’inventaire de l’hôte

Modifier le mode d’inventaire et ajouter l’emplacement

[Requête](/manual/api#performing-requests):

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

Réponse :

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

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

[comment]: # ({603ba164-5cc5d950})
#### Mise à jour des tags d’hôte

Remplacez tous les tags d’hôte par un nouveau.

[Requête](/manual/api#performing-requests):

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

Réponse :

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

[comment]: # ({/603ba164-5cc5d950})

[comment]: # ({58eba4cd-ae2d89bf})
#### Mise à jour des macros d’hôte découvertes

Convertissez la macro « automatique » créée par la règle de découverte en macro « manuelle » et modifiez sa valeur en « new-value ».

[Requête](/manual/api#performing-requests):

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

Réponse :

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

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

[comment]: # ({1948c7c9-f620e859})
#### Mise à jour du chiffrement de l'hôte

Mettez à jour l'hôte « 10590 » afin d'utiliser uniquement le chiffrement PSK pour les connexions de l'hôte vers le serveur Zabbix, et modifiez l'identité PSK ainsi que la clé PSK.
Notez que l'hôte doit être [préconfiguré pour utiliser PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).

[Requête](/manual/api#performing-requests) :

```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
}
```

Réponse :

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

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

[comment]: # ({78cf261e-23501347})
### Voir aussi

-   [host.massadd](massadd)
-   [host.massupdate](massupdate)
-   [host.massremove](massremove)
-   [Groupe d'hôtes](/manual/api/reference/hostgroup/object#host-group)
-   [Modèle](/manual/api/reference/template/object#template)
-   [Macro utilisateur](/manual/api/reference/usermacro/object#hosttemplate-level-macro)
-   [Interface d'hôte](/manual/api/reference/hostinterface/object#host-interface)
-   [Inventaire d'hôte](object#host-inventory)
-   [Balise d'hôte](object#host-tag)
-   [proxy](/manual/api/reference/proxy/object#proxy)
-   [Groupe de proxy](/manual/api/reference/proxygroup/object#proxy-group)

[comment]: # ({/78cf261e-23501347})

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

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

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