device.get

Diese Methode ermöglicht das Abrufen mobiler Geräte zur Verwendung mit der Zabbix Mobile App.

Die Methode ist für Benutzer mit den Rollen User, Admin und Super admin verfügbar, wenn EnableMobileDevices aktiviert ist und der Benutzer Zugriff auf Geräte hat.
Der Zugriff auf API-Methoden kann in der Konfiguration der Benutzerrolle entzogen werden.

Benutzer mit den Rollen User und Admin können nur ihre eigenen Geräte abrufen.

Methodensignatur: integer/array device.get(object parameters)

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

Parameter

Parameter Typ Beschreibung
deviceids ID/array Gibt nur Geräte mit den angegebenen Geräte-IDs zurück.
userids ID/array Gibt nur Geräte zurück, die Benutzern mit den angegebenen Benutzer-IDs gehören.
roleids ID/array Gibt nur Geräte zurück, die Benutzern mit den angegebenen Benutzerrollen-IDs gehören.
usrgrpids ID/array Gibt nur Geräte zurück, die Benutzern mit den angegebenen Benutzergruppen-IDs gehören.
sortfield string/array Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: deviceid, name.
countOutput boolean Diese Parameter werden in der Referenzdokumentation beschrieben.
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Rückgabewerte

Gibt entweder ein Array von Objekten oder die Anzahl der abgerufenen Objekte zurück (wenn countOutput verwendet wird).

Beispiele

Geräte abrufen

Rufen Sie die Geräte ab, die zu Benutzern mit den Benutzer-IDs 1, 2 und 3 gehören.
Beachten Sie, dass Benutzer 2 (Gast) keine Geräte besitzt und Gerät 3 noch nicht zur mobilen Zabbix-App hinzugefügt oder darin authentifiziert wurde.

Anfrage:

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

Antwort:

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