device.get

Ta metoda umożliwia pobieranie urządzeń mobilnych używanych z aplikacją mobilną Zabbix.

Metoda jest dostępna dla użytkowników typu User, Admin i Super admin, jeśli parametr EnableMobileDevices jest włączony, a użytkownik ma dostęp do urządzeń. Dostęp do metod API można odebrać w konfiguracji roli użytkownika.

Użytkownicy typu User i Admin mogą pobierać tylko własne urządzenia.

Sygnatura metody: integer/array device.get(object parameters)

Źródło metody: CDevice::get() w ui/include/classes/api/services/CDevice.php

Parametry

Parametr Typ Opis
deviceids ID/array Zwraca tylko urządzenia o podanych identyfikatorach urządzeń.
userids ID/array Zwraca tylko urządzenia należące do użytkowników o podanych identyfikatorach użytkowników.
roleids ID/array Zwraca tylko urządzenia należące do użytkowników o podanych identyfikatorach ról użytkowników.
usrgrpids ID/array Zwraca tylko urządzenia należące do użytkowników o podanych identyfikatorach grup użytkowników.
sortfield string/array Sortuje wynik według podanych właściwości.

Możliwe wartości: deviceid, name.
countOutput boolean Te parametry opisano w komentarzu referencyjnym.
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Wartości zwracane

Zwraca tablicę obiektów albo liczbę pobranych obiektów (jeśli użyto countOutput).

Przykłady

Pobieranie urządzeń

Pobierz urządzenia należące do użytkowników o następujących identyfikatorach użytkowników: 1, 2, 3.
Należy pamiętać, że użytkownik 2 (gość) nie ma żadnych urządzeń, a urządzenie 3 nie zostało jeszcze dodane ani uwierzytelnione w aplikacji mobilnej Zabbix.

Żądanie:

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

Odpowiedź:

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