dservice.get

Descripción

integer/array dservice.get(object parameters)

El método permite recuperar servicios descubiertos de acuerdo con los parámetros suministrados.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro	Tipo	Descripción
dserviceids	ID/array	Devolver solo los servicios descubiertos con los IDs dados.
dhostids	ID/array	Devolver solo los servicios descubiertos que pertenecen a los hosts descubiertos dados.
dcheckids	ID/array	Devolver solo los servicios descubiertos que han sido detectados por las comprobaciones de descubrimiento dadas.
druleids	ID/array	Devolver solo los servicios descubiertos que han sido detectados por las reglas de descubrimiento dadas.
selectDRules	consulta	Devolver una propiedad `drules` con un array de las reglas de descubrimiento que detectaron el servicio.
selectDHosts	consulta	Devolver una propiedad `dhosts` con un array de los hosts descubiertos a los que pertenece el servicio.
selectHosts	consulta	Devolver una propiedad `hosts` con los hosts con la misma dirección IP y proxy que el servicio. Admite `count`.
limitSelects	entero	Limita el número de registros devueltos por las subselecciones. Se aplica a las siguientes subselecciones: `selectHosts` - el resultado se ordenará por `hostid`.
sortfield	cadena/array	Ordenar el resultado por las propiedades dadas. Valores posibles: `dserviceid`, `dhostid`, `ip`.
countOutput	booleano	Estos parámetros se describen en el comentario de referencia.
editable	booleano
excludeSearch	booleano
filter	objeto
limit	entero
output	consulta
preservekeys	booleano
search	objeto
searchByAny	booleano
searchWildcardsEnabled	booleano
sortorder	cadena/array
startSearch	booleano

Valores de retorno

(entero/matriz) Devuelve:

una matriz de objetos;
el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperar servicios descubiertos en un host

Recupere todos los servicios descubiertos detectados en el equipo descubierto "11" .

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "dservice.get",
           "params": {
               "output": "extend",
               "dhostids": "11"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "dserviceid": "12",
                   "dhostid": "11",
                   "value": "",
                   "port": "80",
                   "status": "1",
                   "lastup": "0",
                   "lastdown": "1348650607",
                   "dcheckid": "5",
                   "ip": "192.168.1.134",
                   "dns": "john.local"
               },
               {
                   "dserviceid": "13",
                   "dhostid": "11",
                   "value": "",
                   "port": "21",
                   "status": "1",
                   "lastup": "0",
                   "lastdown": "1348650610",
                   "dcheckid": "6",
                   "ip": "192.168.1.134",
                   "dns": "john.local"
               }
           ],
           "id": 1
       }

Ver también

Fuente

CDService::get() en ui/include/classes/api/services/CDService.php.

Documentation