device.get

Šī metode ļauj izgūt mobilās ierīces izmantošanai ar Zabbix mobilo lietotni.

Metode ir pieejama User, Admin un Super admin lietotājiem, ja ir iespējots EnableMobileDevices un lietotājam ir piekļuve ierīcēm. Piekļuvi API metodēm var atsaukt lietotāja lomas konfigurācijā.

User un Admin lietotāji var izgūt tikai savas ierīces.

Metodes paraksts: integer/array device.get(object parameters)

Metodes avots: CDevice::get() failā ui/include/classes/api/services/CDevice.php

Parametri

Parametrs Tips Apraksts
deviceids ID/array Atgriež tikai ierīces ar norādītajiem ierīču ID.
userids ID/array Atgriež tikai ierīces, kas pieder lietotājiem ar norādītajiem lietotāju ID.
roleids ID/array Atgriež tikai ierīces, kas pieder lietotājiem ar norādītajiem lietotāju lomu ID.
usrgrpids ID/array Atgriež tikai ierīces, kas pieder lietotājiem ar norādītajiem lietotāju grupu ID.
sortfield string/array Kārto rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: deviceid, name.
countOutput boolean Šie parametri ir aprakstīti atsauces komentāros.
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Atgrieztās vērtības

Atgriež objektu masīvu vai izgūto objektu skaitu (ja tiek izmantots countOutput).

Piemēri

Ierīču izgūšana

Izgūstiet ierīces, kas pieder lietotājiem ar šādiem lietotāju ID: 1, 2, 3.
Ņemiet vērā, ka lietotājam 2 (viesim) nav ierīču un ierīce 3 vēl nav pievienota vai autentificēta Zabbix mobilajā lietotnē.

Pieprasījums:

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

Atbilde:

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