Abfrage von MDM-Geräteattributen für POST-Anforderungen

Die API kann mehrere Werte für bestimmte Abfragekriterien übergeben. Wenn es sich bei den Abfragekriterien um macaddresshandelt, kann die API eine Liste mit Mac-Adressen für die Abfrage übergeben.

Anforderung

POST /ciscoise/batchdevices/? Content Type Header: application/x-www-form-urlencoded

Die API ist die POST -Version der MDM Device Attributes Query -API. Funktional ist die API gleich der GET-Version.

Tabelle 1. Abfrageparameter für MDM-Einheitenattribute für die POST-Anforderung
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/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

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>