Zabbix Documentation 4.0

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


Sidebar

fr:manual:api:reference:host:massupdate

host.massupdate

Description

object host.massupdate(object parameters)

Cette méthode permet de remplacer ou de supprimer simultanément des objets liés et de mettre à jour des propriétés sur plusieurs hôtes.

Paramètres

(object) Paramètres contenant les ID des hôtes à mettre à jour et les propriétés à mettre à jour.

En plus des propriétés de l'objet hôte standard, la méthode accepte les paramètres suivants.

Paramètre Type Description
hosts
(obligatoire)
object/array Hôtes à mettre à jour.

Les hôtes doivent avoir la propriété hostid définie.
groups object/array Groupes d'hôtes en remplacement des groupes d'hôtes actuels auxquels appartiennent les hôtes.

Les hôtes doivent avoir la propriété groupid définie.
interfaces object/array Interfaces hôtes en remplacement des interfaces hôtes actuelles sur les hôtes donnés.
inventory object Propriétés d'inventaire d'hôte.

Le mode d'inventaire de l'hôte ne peut pas être mis à jour à l'aide du paramètre inventory, utiliser plutôt inventory_mode.
inventory_mode integer Mode de peuplement de l'inventaire hôte.

Se référer à la page de l'objet Inventaire d'hôte pour une liste des modes d'inventaire supportés.
macros object/array Macros utilisateur en remplacement des macros utilisateur actuelles sur les hôtes donnés.
templates object/array Modèles en remplacement des modèles actuellement liés sur les hôtes donnés.

Les modèles doivent avoir la propriété templateid définie.
templates_clear object/array Modèles à délier et effacer des hôtes donnés.

Les modèles doivent avoir la propriété templateid définie.

Valeurs retournées

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

Exmples

Activation de plusieurs hôtes

Activer la surveillance de deux hôtes, c’est-à-dire, définir leur statut à 0.

Requête :

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

Réponse :

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

Voir également

Source

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