調用該接口批量校驗在基礎型實例或MQTT云網關產品下導入的設備。
QPS限制
單個阿里云賬號調用該接口的每秒請求數(QPS)最大限制為100。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | BatchCheckImportDevice | 系統規定參數。取值:BatchCheckImportDevice。 |
ProductKey | String | 是 | a1BwAGV**** | 設備所屬云網關產品的ProductKey。 |
DeviceList.N.DeviceName | String | 是 | light | 設備的名稱。 設備名稱支持英文字母、數字、短劃線(-)、下劃線(_)、at(@)、英文句號(.)和英文冒號(:),長度限制為4~32個字符。 設備名稱在產品維度下不可重復。 說明 單次調用該接口,最多能傳入10,000個設備名稱。超過該限制的數據會被丟棄。 |
DeviceList.N.DeviceSecret | String | 是 | b4d43f7******10ba5e5 | 設備的密鑰。 設備密鑰支持英文字母、數字、短劃線(-)、下劃線(_)、at(@)、英文句號(.)和英文冒號(:),長度限制為1~32個字符。 說明 單次調用該接口,最多能傳入10,000個設備密鑰。超過該限制的數據會被丟棄。 |
DeviceList.N.Sn | String | 否 | QC4******001 | 設備的序列號。 序列號支持英文字母、數字和下劃線(_),長度限制為1~64個字符。 說明 單次調用該接口,最多能傳入10,000個設備序列號。超過該限制的數據會被丟棄。 |
IotInstanceId | String | 否 | iot-1n8t**** | 實例ID。您可在物聯網平臺控制臺的實例概覽頁面,查看當前實例的ID。 重要
實例的更多信息,請參見實例概述。 |
調用API時,除了本文介紹的該API的特有請求參數,還需傳入公共請求參數。公共請求參數說明,請參見公共參數文檔。
返回數據
名稱 |
類型 |
示例值 |
描述 |
Code | String | iot.system.SystemException | 調用失敗時,返回的錯誤碼。更多信息,請參見錯誤碼。 |
Data | Struct | 調用成功時,如果有校驗失敗的數據,則返回對應的失敗信息。 |
|
InvalidDetailList | Array of InvalidDetailList | 不合法設備列表。 |
|
DeviceName | String | light% | 設備名稱。 |
DeviceSecret | String | ^67$ | 設備密鑰。 |
ErrorMsg | String | The device name is illegal. | 導入設備失敗時,返回的出錯信息。 |
Sn | String | QC4001# | 設備SN碼。 |
InvalidDeviceNameList | List | { "InvalidDeviceNameList": [ "APT$", "aw" ] } | 設備信息校驗失敗時,返回的不合法設備名稱的列表。 |
InvalidDeviceSecretList | List | { "InvalidDeviceSecretList": [ "^67$", "1" ] } | 設備信息校驗失敗時,返回的不合法設備密鑰的列表。 |
InvalidSnList | List | { "InvalidSnList": [ "" ] } | 設備信息校驗失敗時,返回的不合法設備序列號的列表。 |
RepeatedDeviceNameList | List | { "RepeatedDeviceNameList": [ "abcd", "asdf" ] } | 設備信息校驗失敗時,返回的重復設備名稱的列表。 |
ErrorMessage | String | 系統異常 | 調用失敗時,返回的出錯信息。 |
RequestId | String | E4C0FF92-2A86-41DB-92D3-73B60310D25E | 阿里云為該請求生成的唯一標識符。 |
Success | Boolean | true | 表示是否調用成功。
|
示例
請求示例
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=BatchCheckImportDevice
&DeviceList.1.DeviceName=device1
&DeviceList.2.DeviceName=device2
&DeviceList.1.DeviceSecret=b4d43f7******10ba5e5
&DeviceList.2.DeviceSecret=912179******700210b4
&ProductKey=a1BwAGV****
&IotInstanceId=iot-1n8t****
&<公共請求參數>
正常返回示例
XML
格式
<BatchCheckImportDeviceResponse>
<RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
<Success>true</Success>
</BatchCheckImportDeviceResponse>
JSON
格式
{
"RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
"Success": true
}