L'API può passare più valori per criteri di query specifici. Se il criterio di query è macaddress, l'API può passare un elenco di indirizzi Mac per la query.
Richiesta
POST /ciscoise/batchdevices/? Content Type Header:
application/x-www-form-urlencoded
L'API è la versione POST dell'API MDM Device Attributes
Query . Funzionalmente, l'API è uguale alla versione GET .
Tabella 1. Parametri di query degli attributi del dispositivo MDM per la richiesta POST
| 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/devices/?paging=0&querycriteria=macaddress&value=000000000000&filter=all
https://services.fiberlink.com/ciscoise/devices/?paging=0&
querycriteria=meid&value=1234567890abcd&filter=all
https://services.fiberlink.com/ciscoise/devices/?paging=0&querycriteria=username&value=abcd1234&filter=register_status+compliance_status
https://services.fiberlink.com/ciscoise/devices/?paging=0&querycriteria=compliance&value=false&filter=all
https://services.fiberlink.com/ciscoise/devices/?paging=0&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>