L'API interroga gli attributi del dispositivo. Ogni query ha una categoria come indirizzo MAC, stato di conformità, valore e un filtro di attributo per stabilire quali informazioni restituire nella risposta.
Richiesta
GET /ciscoise/devices/? Content Type Header:
application/x-www-form-urlencoded
Il numero massimo di periferiche restituite è il valore di query_max_size restituito dall'API delle informazioni del server MDM. Il valore predefinito è 5000.
La chiamata iniziale di questa API passa le informazioni di paginazione come 0. Se l'MDM ha più dispositivi rispetto al query_max_size, l'MDM può progettare il proprio schema di paginazione e restituisce paging_info nella risposta. Queste informazioni fanno parte dell' URL nella successiva chiamata di ISE. Se le informazioni di paginazione restituiscono un 0 nella risposta o non restituiscono le informazioni di paginazione nella risposta, vengono restituiti tutti i record.
Tabella 1. Parametri di query degli attributi del dispositivo MDM
| Nome del parametro |
Obbligatorio o facoltativo |
Descrizione |
| Paging |
Obbligatorio |
0 viene definito come prima chiamata o come tutti i record. |
| Querycriteria |
Facoltativo |
Scegliere la categoria dei criteri di query:
|
| Value |
Facoltativo |
Scegliere il valore dei criteri di query:
- Macaddress: 12 HEX senza separatore.
- Meid: codice HEX di 14 caratteri o codice decimale di 10 cifre.
- Uid: Identificatore dispositivo univoco.
- Imei: Identità dell'apparecchiatura della stazione mobile internazionale.
- Conformità: True o false.
- Nome utente: valore stringa.
|
| Filter |
Obbligatorio |
Utilizzare un qualsiasi numero di filtri separati da +:
- Tutti
- Register_status: valore booleano come true o false.
- Conformità: lo stato è true o false.
- Disk_encryption_on: valore booleano come true o false.
- Pin_lock_on: valori booleani come true o false.
- Jail_broken: valore booleano come true o false.
- Produttore: valore stringa.
- Modello: valore stringa.
- Imei: valore stringa.
- Meid: valore stringa.
- Udid: valore stringa.
- HTTP : Metodo URL.
- Serial_number: valore stringa.
- OS_version: valore stringa.
- Phone_number: valore stringa.
|
Richiesta di esempio
https://services.fiberlink.com/ciscoise/batchdevices/paging=0&querycriteria=macaddress&value=000000000000&filter=all
Risposta di esempio
<ise_api >
<name>attributes</name> <api_version>2</api_version> <paging_info>0</paging_info>
<deviceList> <device> <macaddress>000000000000</macaddress> <attributes>
<register_status>true</register_status> <compliance> <status>false<status>
<failure_reason>something not compliant</failure_reason> <remediation>instruction on how to
rememdiate</remediation> </compliance> <disk_encryption_on>yes</ disk_encryption_on>
<pin_lock_on>true</ pin_lock_on> <jail_broken>false</ jail_broken>
<manufacturer>Samsung</ manufacturer> <imei>1234567890</imei>
<meid>A0123456789012</meid> <udid>2b6f0cc904d137be2e1730235f5664094b831186</udid>
<os_version>Android,4.3<os_version> </attributes> </device> <deviceList>
</ise_api>