Abfrage von MDM-Geräteattributen

Die API fragt Geräteattribute ab. Jede Abfrage hat eine Kategorie, wie z. B. MAC-Adresse, Konformitätsstatus, Wert und einen Attributfilter, um zu bestimmen, welche Informationen in der Antwort zurückgegeben werden müssen.

Anforderung

GET /ciscoise/devices/? Content Type Header: application/x-www-form-urlencoded

Die maximale Anzahl von Geräten, die zurückgegeben werden, entspricht dem Wert von query_max_size, der von der API für MDM-Serverinformationen zurückgegeben wird. Der Standardwert ist 5000.

Der erste Aufruf dieser API übergibt Paging-Informationen als 0. Wenn das MDM mehr Einheiten als das query_max_size aufweist, kann das MDM sein eigenes Paging-Schema entwerfen und das paging_info in der Antwort zurückgeben. Diese Informationen sind Teil der URL im nächsten Aufruf von ISE. Wenn die Paging-Informationen eine 0 in der Antwort zurückgeben oder keine Paging-Informationen in der Antwort zurückgeben, werden alle Datensätze zurückgegeben.

Tabelle 1. Parameter für die Abfrage von MDM-Geräteattributen
Parametername Erforderlich oder optional Beschreibung
Paging Erforderlich 0 ist als erster Aufruf oder für alle Datensätze definiert.
Querycriteria Optionale Wählen Sie die Kategorie für die Abfragekriterien aus:
  • Mac-Adresse
  • Compliance-
Value Optionale Wählen Sie den Wert für die Abfragekriterien aus:
  • Macaddress: 12 HEX ohne Trennzeichen.
  • Meid: Hexadezimaler Code aus 14 Zeichen oder ein Dezimalcode aus 10 Ziffern.
  • Uid: Eindeutige Geräte-ID.
  • Imei: International Mobile Station Equipment Identity.
  • Compliance: True oder false.
  • Username: Zeichenfolgewert.
Filter Erforderlich Verwenden Sie eine beliebige Anzahl von Filtern, die durch + getrennt werden:
  • Alle
  • Register_status: Boolescher Wert, z. B. true oder false.
  • Compliance: Statusangabe mit true oder false.
  • Disk_encryption_on: Boolescher Wert, z. B. true oder false.
  • Pin_lock_on: Boolescher Wert, z. B. true oder false.
  • Jail_broken: Boolescher Wert, z. B. true oder false.
  • Manufacturer: Zeichenfolgewert.
  • Model: Zeichenfolgewert.
  • Imei: Zeichenfolgewert.
  • Meid: Zeichenfolgewert.
  • Udid: Zeichenfolgewert.
  • HTTP: Methoden-URL.
  • Serial_number: Zeichenfolgewert.
  • OS_version: Zeichenfolgewert.
  • Phone_number: Zeichenfolgewert.

Beispielanforderung

https://services.fiberlink.com/ciscoise/batchdevices/paging=0&querycriteria=macaddress&value=000000000000&filter=all

Beispielantwort

<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>