device.get
Questo metodo consente di recuperare i dispositivi mobili da utilizzare con la Zabbix mobile app.
Il metodo è disponibile per gli utenti User, Admin e Super admin se EnableMobileDevices è abilitato e l'utente dispone dell'accesso ai dispositivi.
L'accesso ai metodi API può essere revocato nella configurazione del ruolo utente.
Gli utenti User e Admin possono recuperare solo i propri dispositivi.
Firma del metodo: integer/array device.get(object parameters)
Origine del metodo: CDevice::get() in ui/include/classes/api/services/CDevice.php
Parametri
| Parametro | Tipo | Descrizione |
|---|---|---|
| deviceids | ID/array | Restituisce solo i dispositivi con gli ID dispositivo specificati. |
| userids | ID/array | Restituisce solo i dispositivi appartenenti agli utenti con gli ID utente specificati. |
| roleids | ID/array | Restituisce solo i dispositivi appartenenti agli utenti con gli ID dei ruoli utente specificati. |
| usrgrpids | ID/array | Restituisce solo i dispositivi appartenenti agli utenti con gli ID dei gruppi utente specificati. |
| sortfield | string/array | Ordina il risultato in base alle proprietà specificate. Valori possibili: deviceid, name. |
| countOutput | boolean | Questi parametri sono descritti nella documentazione di riferimento. |
| excludeSearch | boolean | |
| filter | object | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
Valori restituiti
Restituisce un array di oggetti oppure il numero di oggetti recuperati (se viene utilizzato countOutput).
Esempi
Recuperare i dispositivi
Recupera i dispositivi appartenenti agli utenti con questi ID utente: 1, 2, 3.
Nota che l'utente 2 (guest) non dispone di dispositivi e che il dispositivo 3 non è ancora stato aggiunto o autenticato nell'app mobile Zabbix.
{
"jsonrpc": "2.0",
"method": "device.get",
"params": {
"output": "extend",
"userids": [1, 2, 3]
},
"id": 1
}Risposta:
{
"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
}