device.get

Este método permite recuperar dispositivos móviles para utilizarlos con la aplicación móvil de Zabbix.

El método está disponible para usuarios User, Admin y Super admin si EnableMobileDevices está habilitado y el usuario tiene acceso a los dispositivos. El acceso a los métodos de la API se puede revocar en la configuración del rol de usuario.

Los usuarios User y Admin solo pueden recuperar sus propios dispositivos.

Firma del método: integer/array device.get(object parameters)

Origen del método: CDevice::get() en ui/include/classes/api/services/CDevice.php

Parámetros

Parámetro Tipo Descripción
deviceids ID/array Devuelve solo los dispositivos con los ID de dispositivo indicados.
userids ID/array Devuelve solo los dispositivos pertenecientes a usuarios con los ID de usuario indicados.
roleids ID/array Devuelve solo los dispositivos pertenecientes a usuarios con los ID de rol de usuario indicados.
usrgrpids ID/array Devuelve solo los dispositivos pertenecientes a usuarios con los ID de grupo de usuarios indicados.
sortfield string/array Ordena el resultado según las propiedades indicadas.

Valores posibles: deviceid, name.
countOutput boolean Estos parámetros se describen en los comentarios de referencia.
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valores devueltos

Devuelve un array de objetos o el número de objetos recuperados (si se utiliza countOutput).

Ejemplos

Recuperar dispositivos

Recupere los dispositivos pertenecientes a los usuarios con estos ID de usuario: 1, 2, 3.
Tenga en cuenta que el usuario 2 (invitado) no tiene dispositivos y que el dispositivo 3 aún no se ha añadido ni autenticado en la aplicación móvil de Zabbix.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "device.get",
    "params": {
        "output": "extend",
        "userids": [1, 2, 3]
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "deviceid": "1",
            "userid": "1",
            "uuid": "019f930e-0ea2-7c1f-9dcc-0fbb60c40664",
            "name": "Google Pixel 10",
            "status": "1",
            "activated_at": "1784533122",
            "lastaccess": "1784879933"
        },
        {
            "deviceid": "2",
            "userid": "1",
            "uuid": "019d00fb-9e87-7ad5-bb4e-978467254aff",
            "name": "Apple iPhone 15 Pro",
            "status": "1",
            "activated_at": "1784533225",
            "lastaccess": "0"
        },
        {
            "deviceid": "3",
            "userid": "3",
            "uuid": "019d00fb-9e87-7ad5-bb4e-6ed88a2297ee",
            "name": "",
            "status": "0",
            "activated_at": "0",
            "lastaccess": "0"
        }
    ],
    "id": 1
}