API は、特定のクエリ基準に関する複数の値を渡すことができます。 クエリー基準が macaddressの場合、API はクエリーの Mac アドレスのリストを渡すことができます。
要求
POST /ciscoise/batchdevices/? Content Type Header:
application/x-www-form-urlencoded
API は、 MDM Device Attributes
Query API の POST バージョンです。 機能的には、このAPIはGETバージョンに相当します。
表 1. MDMデバイスはPOST要求に関するクエリ・パラメーターに属します
| パラメーター名 |
必須またはオプション |
説明 |
| Paging |
必須 |
0 が最初の呼び出しとして定義されます (すべてのレコード)。 |
| Querycriteria |
オプション |
以下の照会基準カテゴリーを選択します。
|
| 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/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
サンプル応答
<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>