hostinterface.get

Descripción

integer/array hostinterface.get(object parameters)

Este procedimiento nos permite recuperar las interfaces de host según los parámetros dados.

Este procedimiento está disponible para todo tipo de usuarios. Los permisos para invocar este procedimiento pueden ser revocados en los roles de usuario. Mirar User Roles para más información.

Parámetros

(object) Los parámetros que definen la salida deseada.

Este procedimiento soporta los siguientes parámetros.

Parameter	Type	Description
hostids	string/array	Devuelve solo las interfaces del host con la IDs.
itemids	string/array	Devuelve solo las interfaces del host en usadas por los elementos dados.
triggerids	string/array	Devuelve solo las interfaces del host usadas por los elementos dados en los disparadores.
selectItems	query	Devuelve una propiedad items con los elementos que usan la interfaz. Soporta `count`
selectHosts	query	Devuelve una propiedad hosts con una matriz de hosts que usan la interfaz.
limitSelects	integer	Limita el numero de registros devueltos por subconsultas. Se aplica en las siguientes subconsultas:
selectItems``.\| \|sortfield\|string/array\|Ordena el resultado por las propiedad dadas. Los posibles valores son:`interfaceid`,`dns`,`ip`.\| \|countOutput\|boolean\| Estos parametros son comunes para todos los procedimientos`get` están descritos en detalle en la página reference commentary .
editable	boolean
excludeSearch	boolean
filter	object
limit	integer
nodeids	string/array
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	booblean

Valores de devueltos

(integer/array) Returns either:

una matriz de objetos;
la suma de los objetos devueltos, si el parámetros countOutput está siendo usado

Ejemplos

Recuperar interfaces del equipo

Recuperar todos los datos sobre las interfaces utilizadas por el equipo "30057".

Solicitud:

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

Respuesta:

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

Ver también

Host
Item

Fuente

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

Documentation