hostinterface.get

Description

object hostinterface.create(object/array hostInterfaces)

Cette méthode permet de créer de nouvelles interfaces hôtes.

Cette méthode est disponible pour tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir Rôles Utilisateur pour plus d'informations.

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
hostids	string/array	Renvoie uniquement les interfaces hôtes utilisées par les hôtes donnés.
interfaceids	string/array	Renvoie uniquement les interfaces hôtes avec les ID donnés.
itemids	string/array	Renvoie uniquement les interfaces hôtes utilisées par les éléments donnés.
triggerids	string/array	Renvoie uniquement les interfaces hôtes utilisées par les éléments des déclencheurs donnés.
selectItems	query	Renvoie une propriété items contenant les éléments qui utilisent l'interface. Supporte `count`.
selectHosts	query	Renvoie une propriété hosts contenant un tableau les hôtes qui utilisent l'interface .
limitSelects	integer	Limite le nombre d'enregistrements renvoyés par les sous-requêtes. S'applique aux sous-requêtes suivantes : `selectItems`.
sortfield	string/array	Trie le résultat par les propriétés données. Les valeurs possibles sont : `interfaceid`, `dns`, `ip`.
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
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
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érer les interfaces hôtes

Récupérez toutes les données sur les interfaces utilisées par l'hôte "30057".

Requête :

{
           "jsonrpc": "2.0",
           "method": "hostinterface.get",
           "params": {
               "output": "extend",
               "hostids": "30057"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "interfaceid": "50039",
                   "hostid": "30057",
                   "main": "1",
                   "type": "1",
                   "useip": "1",
                   "ip": "::1",
                   "dns": "",
                   "port": "10050",
                   "available": "0",
                   "error": "",
                   "errors_from": "0",
                   "disable_until": "0",
                   "details": []
               },
               {
                   "interfaceid": "55082",
                   "hostid": "30057",
                   "main": "0",
                   "type": "1",
                   "useip": "1",
                   "ip": "127.0.0.1",
                   "dns": "",
                   "port": "10051",
                   "available": "0",
                   "error": "",
                   "errors_from": "0",
                   "disable_until": "0",
                   "details": {
                       "version": "2",
                       "bulk": "0",
                       "community": "{$SNMP_COMMUNITY}"
                   }
               }
           ],
           "id": 1
       }

Voir également

Source

CHostInterface::get() dans ui/include/classes/api/services/CHostInterface.php.

Documentation