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

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

[comment]: # ({895b428e-7ee0d5db})
### Description

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

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

[comment]: # ({/895b428e-7ee0d5db})

[comment]: # ({ee3ca521-503bb6ac})
### 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 données
seront mises à jour, toutes les autres resteront inchangées.

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

|Paramètre|Type|Description|
|----------|----|-----------|
|groups|object/array|Groupes d'hôtes en remplacement des groupes d'hôtes actuels auxquels appartient l'hôte.<br><br>Les groupes hôtes doivent avoir la propriété `groupid` définie. Tous les groupes hôtes qui ne figurent pas dans la demande seront déliés.|
|interfaces|object/array|Interfaces hôtes en remplacement des interfaces hôtes actuelles.<br><br>Toutes les interfaces qui ne figurent pas dans la demande seront supprimées.|
|inventory|object|Propriétés d'inventaire d'hôte.|
|macros|object/array|Macros utilisateur en remplacement des macros utilisateur actuelles.<br><br>Toutes les macros non répertoriées dans la demande seront supprimées.|
|templates|object/array|Modèles en remplacement des modèles actuellement liés. Tous les modèles qui ne sont pas répertoriés dans la demande seront uniquement déliés.<br><br>Les modèles doivent avoir la propriété `templateid` définie.|
|templates\_clear|object/array|Modèles à délier et supprimer de l'hôte.<br><br>Les modèles doivent avoir la propriété `templateid` définie.|

::: notetip
Contrairement à l'interface Zabbix, lorsque `name` (nom
d'hôte visible) est identique à `host` (nom d'hôte technique), la mise à
jour de `host` via l'API ne mettra pas automatiquement à jour `name` .
Les deux propriétés doivent être mises à jour
explicitement.
:::

[comment]: # ({/ee3ca521-503bb6ac})

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

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

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

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

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

[comment]: # ({34ca5311-ce50c453})
#### Activation d'un hôte

Activer la surveillance d’hôte, c’est-à-dire définir son statut à 0.

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "status": 0
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

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

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

[comment]: # ({cc744cd9-bea1db7e})
#### Délier des modèles

Délier et effacer deux modèles de l'hôte.

Requête :

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

Réponse :

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

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

[comment]: # ({7b70206f-d5c60dd8})
#### Mettre à jour des macros

Remplacer toutes les macros hôtes par deux nouvelles.

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "macros": [
            {
                "macro": "{$PASS}",
                "value": "password"
            },
            {
                "macro": "{$DISC}",
                "value": "sda"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

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

[comment]: # ({/7b70206f-d5c60dd8})

[comment]: # ({53e230a9-6b8e3616})
#### Mettre à jour l'inventaire d'hôte

Changer le mode d'inventaire et ajouter l'emplacement

Requête :

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

Réponse :

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10387"
        ]
    },
    "id": 2
}
```

[comment]: # ({/53e230a9-6b8e3616})

[comment]: # ({df76463f-0ffd02f4})
### Voir également

-   [host.massadd](/fr/manual/api/reference/host/massadd)
-   [host.massremove](/fr/manual/api/reference/host/massremove)
-   [host.massupdate](/fr/manual/api/reference/host/massupdate)
-   [Modèle](/fr/manual/api/reference/template/object#modele)
-   [Groupe
    d'Hôte](/fr/manual/api/reference/hostgroup/object#groupe_d_hote)
-   [Macro
    utilisateur](/fr/manual/api/reference/usermacro/object#macro_d_hote)
-   [Interface
    hôte](/fr/manual/api/reference/hostinterface/object#interface_hote)
-   [Inventaire
    d'hôte](/fr/manual/api/reference/host/object#inventaire_d_hote)

[comment]: # ({/df76463f-0ffd02f4})

[comment]: # ({f7c6600c-3b1b47a0})
### Source

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

[comment]: # ({/f7c6600c-3b1b47a0})