device.get

Cette méthode permet de récupérer les appareils mobiles à utiliser avec l'application mobile Zabbix.

La méthode est disponible pour les utilisateurs Utilisateur, Administrateur et Super administrateur si EnableMobileDevices est activé et si l'utilisateur dispose d'un accès aux appareils. L'accès aux méthodes de l'API peut être révoqué dans la configuration du rôle utilisateur.

Les utilisateurs Utilisateur et Administrateur peuvent uniquement récupérer leurs propres appareils.

Signature de la méthode : integer/array device.get(object parameters)

Source de la méthode : CDevice::get() dans ui/include/classes/api/services/CDevice.php

Paramètres

Parameter Type Description
deviceids ID/array Retourne uniquement les appareils avec les ID d'appareil indiqués.
userids ID/array Retourne uniquement les appareils appartenant aux utilisateurs avec les ID utilisateur indiqués.
roleids ID/array Retourne uniquement les appareils appartenant aux utilisateurs avec les ID de rôle utilisateur indiqués.
usrgrpids ID/array Retourne uniquement les appareils appartenant aux utilisateurs avec les ID de groupe d'utilisateurs indiqués.
sortfield string/array Trie le résultat selon les propriétés indiquées.

Valeurs possibles : deviceid, name.
countOutput boolean Ces paramètres sont décrits dans le commentaire de référence.
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valeurs de retour

Renvoie soit un tableau d’objets, soit le nombre d’objets récupérés (si countOutput est utilisé).

Exemples

Récupérer des appareils

Récupérer les appareils appartenant aux utilisateurs dont les ID sont les suivants : 1, 2, 3.
Notez que l'utilisateur 2 (invité) ne possède aucun appareil et que l'appareil 3 n'a pas encore été ajouté ou authentifié dans l'application mobile Zabbix.

Requête :

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

Réponse :

{
    "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
}