Sidebar

Become a monitoring expert!
Sign up for Zabbix training

host.get

Description

integer/array host.get(object parameters)

La méthode permet de récupérer des hôtes en fonction des paramètres donnés.

Paramètres

(object) Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants.

Paramètre Type Description
groupids string/array Renvoie uniquement les hôtes appartenant aux groupes donnés.
applicationids string/array Renvoie uniquement les hôtes ayant les applications données.
dserviceids string/array Renvoie uniquement les hôtes associés aux services découverts donnés.
graphids string/array Renvoie uniquement les hôtes qui ont les graphiques donnés.
hostids string/array Renvoyer uniquement les hôtes avec les ID d'hôte donnés.
httptestids string/array Renvoie uniquement les hôtes ayant les surveillances Web données.
interfaceids string/array Renvoie uniquement les hôtes qui utilisent les interfaces données.
itemids string/array Renvoie uniquement les hôtes ayant les éléments donnés.
maintenanceids string/array Renvoie uniquement les hôtes affectés par les maintenances données.
monitored_hosts flag Renvoyer uniquement les hôtes surveillés.
proxy_hosts flag Renvoie uniquement les proxies.
proxyids string/array Renvoie uniquement les hôtes surveillés par les proxies donnés.
templated_hosts flag Renvoie les hôtes et les modèles.
templateids string/array Renvoie uniquement les hôtes liés aux modèles donnés.
triggerids string/array Renvoie uniquement les hôtes ayant les déclencheurs donnés.
with_items flag Renvoie uniquement les hôtes qui ont des éléments.

Écrase les paramètres with_monitored_items et with_simple_graph_items.
with_applications flag Renvoie uniquement les hôtes ayant des applications.
with_graphs flag Renvoie uniquement les hôtes dotés de graphiques.
with_httptests flag Renvoie uniquement les hôtes disposant de surveillance Web.

Écrase le paramètre with_monitored_httptests.
with_monitored_httptests flag Renvoie uniquement les hôtes ayant des surveillances Web actives.
with_monitored_items flag Renvoie uniquement les hôtes ayant des éléments actifs.

Écrase le paramètre with_simple_graph_items.
with_monitored_triggers flag Renvoie uniquement les hôtes ayant des déclencheurs actifs. Tous les éléments utilisés dans le déclencheur doivent également être activés.
with_simple_graph_items flag Renvoie uniquement les hôtes contenant des éléments contenant des informations de type numérique.
with_triggers flag Renvoie uniquement les hôtes ayant des déclencheurs.

Écrase le paramètre with_monitored_triggers.
withInventory flag Renvoie uniquement les hôtes disposant de données d'inventaire.
selectGroups query Renvoie une propriété groups avec les groupes hôtes auxquels l'hôte appartient.
selectApplications query Renvoie une propriété applications avec les applications hôtes.

Supporte count.
selectDiscoveries query Renvoie une propriété discoveries avec les règles de découverte bas niveau.

Supporte count.
selectDiscoveryRule query Renvoie une propriété discoveryRule avec la règle de découverte de bas niveau qui a créé l'hôte (à partir du prototype d'hôte dans la surveillance VMware).
selectGraphs query Renvoie une propriété graphs avec les graphiques d'hôtes.

Supporte count.
selectHostDiscovery query Renvoie une propriété hostDiscovery avec les données d'objet de découverte d'hôte.

L'objet de découverte d'hôte lie un hôte découvert à un prototype d'hôte ou un prototype à une règle de découverte bas niveau et possède les propriétés suivantes :
host - (string) hôte du prototype d'hôte ;
hostid - (string) ID de l'hôte découvert ou du prototype d'hôte ;
parent_hostid - (string) ID du prototype d'hôte à partir duquel l'hôte a été créé ;
parent_itemid - (string) ID de la règle de découverte bas niveau qui a créé l'hôte découvert ;
lastcheck - (timestamp) heure de la dernière découverte de l'hôte ;
ts_delete - (timestamp) heure à laquelle un hôte qui n'est plus découvert sera supprimé.
selectHttpTests query Renvoie une propriété '' httpTests'' avec les scénarios Web de l'hôte.

Supporte count.
selectInterfaces query Renvoie une propriété interfaces avec les interfaces hôtes.

Supporte count.
selectInventory query Renvoie une propriété inventory avec les données d'inventaire de l'hôte.
selectItems query Renvoie une propriété items avec les éléments de l'hôte.

Supporte count.
selectMacros query Renvoie une propriété macros avec les macros de l'hôte.
selectParentTemplates query Renvoie une propriété parentTemplates avec les modèles auxquels l'hôte est lié.

Supporte count.
selectScreens query Renvoie une propriété screens avec les écrans d'hôtes.

Supporte count.
selectTriggers query Renvoie une propriété triggers avec les déclencheurs de l'hôte.

Supporte count.
filter object Renvoie uniquement les résultats qui correspondent exactement au filtre donné.

Accepte un tableau dans lequel les clés sont des noms de propriétés et les valeurs sont une valeur unique ou un tableau de valeurs à comparer.

Permet le filtrage par les propriétés de l'interface.
limitSelects integer Limite le nombre d'enregistrements renvoyés par les sous-requêtes.

S'applique aux sous-requêtes suivantes:
selectParentTemplates - les résultats seront triés par host ;
selectInterfaces ;
selectItems - triés par name ;
selectDiscoveries - triés par name ;
selectTriggers - triés par description ;
selectGraphs - triés par name ;
selectApplications - triés par name ;
selectScreens - triés par name.
search object Renvoie les résultats correspondant à la recherche générique donnée.

Accepte un tableau dans lequel les clés sont des noms de propriétés et les valeurs sont des chaînes à rechercher. Si aucune option supplémentaire n'est donnée, cela effectuera une recherche LIKE "%…%".

Permet de rechercher par propriétés de l'interface. Fonctionne uniquement avec les champs de texte.
searchInventory object Renvoie uniquement les hôtes dont les données d'inventaire correspondent à la recherche générique donnée.

Ce paramètre est affecté par les mêmes paramètres supplémentaires que "search".
sortfield string/array Trie le résultat en fonction des propriétés données.

Valeurs possibles : hostid, host, name, status.
countOutput boolean Ces paramètres, communs à toutes les méthodes "get", sont décrits dans les commentaires de référence.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valeurs retournées

(integer/array) Retourne soit :

  • un tableau d'objets ;
  • le nombre d'objets récupérés, si le paramètre countOutput a été utilisé.

Exemples

Récupération des données par nom

Récupérer toutes les données sur deux hôtes nommés "Zabbix server" et "Linux server".

Requête :

{
           "jsonrpc": "2.0",
           "method": "host.get",
           "params": {
               "filter": {
                   "host": [
                       "Zabbix server",
                       "Linux server"
                   ]
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "maintenances": [],
                   "hostid": "10160",
                   "proxy_hostid": "0",
                   "host": "Zabbix server",
                   "status": "0",
                   "disable_until": "0",
                   "error": "",
                   "available": "0",
                   "errors_from": "0",
                   "lastaccess": "0",
                   "ipmi_authtype": "-1",
                   "ipmi_privilege": "2",
                   "ipmi_username": "",
                   "ipmi_password": "",
                   "ipmi_disable_until": "0",
                   "ipmi_available": "0",
                   "snmp_disable_until": "0",
                   "snmp_available": "0",
                   "maintenanceid": "0",
                   "maintenance_status": "0",
                   "maintenance_type": "0",
                   "maintenance_from": "0",
                   "ipmi_errors_from": "0",
                   "snmp_errors_from": "0",
                   "ipmi_error": "",
                   "snmp_error": "",
                   "jmx_disable_until": "0",
                   "jmx_available": "0",
                   "jmx_errors_from": "0",
                   "jmx_error": "",
                   "name": "Zabbix server",
                   "description": "The Zabbix monitoring server.",
                   "tls_connect": "1",
                   "tls_accept": "1",
                   "tls_issuer": "",
                   "tls_subject": "",
                   "tls_psk_identity": "",
                   "tls_psk": ""
               },
               {
                   "maintenances": [],
                   "hostid": "10167",
                   "proxy_hostid": "0",
                   "host": "Linux server",
                   "status": "0",
                   "disable_until": "0",
                   "error": "",
                   "available": "0",
                   "errors_from": "0",
                   "lastaccess": "0",
                   "ipmi_authtype": "-1",
                   "ipmi_privilege": "2",
                   "ipmi_username": "",
                   "ipmi_password": "",
                   "ipmi_disable_until": "0",
                   "ipmi_available": "0",
                   "snmp_disable_until": "0",
                   "snmp_available": "0",
                   "maintenanceid": "0",
                   "maintenance_status": "0",
                   "maintenance_type": "0",
                   "maintenance_from": "0",
                   "ipmi_errors_from": "0",
                   "snmp_errors_from": "0",
                   "ipmi_error": "",
                   "snmp_error": "",
                   "jmx_disable_until": "0",
                   "jmx_available": "0",
                   "jmx_errors_from": "0",
                   "jmx_error": "",
                   "name": "Linux server",
                   "description": "",
                   "tls_connect": "1",
                   "tls_accept": "1",
                   "tls_issuer": "",
                   "tls_subject": "",
                   "tls_psk_identity": "",
                   "tls_psk": ""
               }
           ],
           "id": 1
       }

Récupération des groupes d'hôtes

Récupérer les noms des groupes dont l'hôte "Zabbix server" est membre, mais aucun détail sur l'hôte lui-même.

Requête:

{
           "jsonrpc": "2.0",
           "method": "host.get",
           "params": {
               "output": ["hostid"],
               "selectGroups": "extend",
               "filter": {
                   "host": [
                       "Zabbix server"
                   ]
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 2
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "hostid": "10085",
                   "groups": [
                       {
                           "groupid": "2",
                           "name": "Linux servers",
                           "internal": "0",
                           "flags": "0"
                       },
                       {
                           "groupid": "4",
                           "name": "Zabbix servers",
                           "internal": "0",
                           "flags": "0"
                       }
                   ]
               }
           ],
           "id": 2
       }

Récupération des modèles liés

Récupérer les identifiants et les noms des modèles liés à l'hôte "10084".

Requête :

{
           "jsonrpc": "2.0",
           "method": "host.get",
           "params": {
               "output": ["hostid"],
               "selectParentTemplates": [
                   "templateid",
                   "name"
               ],
               "hostids": "10084"
           },
           "id": 1,
           "auth": "70785d2b494a7302309b48afcdb3a401"
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "hostid": "10084",
                   "parentTemplates": [
                       {
                           "name": "Template OS Linux",
                           "templateid": "10001"
                       },
                       {
                           "name": "Template App Zabbix Server",
                           "templateid": "10047"
                       }
                   ]
               }
           ],
           "id": 1
       }

Recherche par données d'inventaire de l'hôte

Récupérer les hôtes qui contiennent "Linux" dans le champ "OS" de l'inventaire d'hôte.

Requête :

{
           "jsonrpc": "2.0",
           "method": "host.get",
           "params": {
               "output": [
                   "host"
               ],
               "selectInventory": [
                   "os"
               ],
               "searchInventory": {
                   "os": "Linux"
               }
           },
           "id": 2,
           "auth": "7f9e00124c75e8f25facd5c093f3e9a0"
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "hostid": "10084",
                   "host": "Zabbix server",
                   "inventory": {
                       "os": "Linux Ubuntu"
                   }
               },
               {
                   "hostid": "10107",
                   "host": "Linux server",
                   "inventory": {
                       "os": "Linux Mint"
                   }
               }
           ],
           "id": 1
       }

Voir également

Source

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