MDM デバイス属性照会

この API はデバイス属性を照会します。 各照会には、MAC アドレス、コンプライアンス・ステータス、値などのカテゴリーがあり、応答で返す情報を決定する属性フィルターがあります。

要求

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

返されるデバイスの最大数は、MDM サーバー情報 API から返される query_max_size の値です。 デフォルト値は 5000 です。

このAPIの初期呼び出しでは、ページング情報が0として渡されます。 MDMにquery_max_sizeよりも多くのデバイスがある場合、MDMは独自のページング・スキームを設計することができ、応答でpaging_infoを戻します。 この情報は、ISE からの次の呼び出しの URL の一部です。 ページング情報が応答で0を戻した場合、または応答内でページング情報を戻さない場合は、すべてのレコードが戻されます。

表 1. MDM デバイス属性照会パラメーター
パラメーター名 必須またはオプション 説明
Paging 必須 0 が最初の呼び出しとして定義されます (すべてのレコード)。
Querycriteria オプション 以下の照会基準カテゴリーを選択します。
  • Macアドレス
  • コンプライアンス
Value オプション 以下の照会基準値を選択します。
  • Macaddress: 分離文字なしの 12 個の 16 進数。
  • Meid: 14 文字の 16 進コードまたは 10 桁の 10 進コード。
  • Uid: 固有のデバイス ID。
  • Imei: International Mobile Station Equipment Identity。
  • Compliance: true または false。
  • Username: ストリング値。
Filter 必須 +で区切られた任意の数のフィルターを使用します：
  • すべて
  • Register_status: true または false などのブール値。
  • Compliance: true または false のステータス。
  • Disk_encryption_on: true または false などのブール値。
  • Pin_lock_on: true または false などのブール値。
  • Jail_broken: true または false などのブール値。
  • Manufacturer: ストリング値。
  • Model: ストリング値。
  • Imei: ストリング値。
  • Meid: ストリング値。
  • Udid: ストリング値。
  • HTTP: メソッド URL。
  • Serial_number: ストリング値。
  • OS_version: ストリング値。
  • Phone_number: ストリング値。

サンプル要求

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

サンプル応答

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