全部产品
阿里云办公

批量获取设备状态

更新时间:2018-01-30 10:08:43

请求参数

名称 类型 是否必须 描述
<公共参数> 公共参数
ProductKey String 产品唯一ID
DeviceNames List 设备名称列表,单次最多支持查询50个设备

返回参数

名称 类型 描述
RequestId String 当前请求在阿里云产生的请求ID
Success Boolean 表示调用成功与否
ErrorMessage String 出错信息
DeviceStatusList List 设备信息列表,设备信息见DeviceStatus定义

DeviceStatus定义

名称 类型 描述
DeviceName String 设备名称
Status String 设备状态, 可选值:ONLINE, OFFLINE, UNACTIVE

示例

  • 请求示例

    1. https://iot.cn-shanghai.aliyuncs.com/?Action=BatchGetDeviceState
    2. &productKey=...
    3. &DeviceName.1=...
    4. &DeviceName.3=...
    5. &DeviceName.2=...
    6. &DeviceName.4=...
    7. &<[公共请求参数]>
  • SDK示例代码 [SDK Demo下载]

  • 返回示例

    JSON示例

    1. {
    2. DeviceStatusList:{
    3. DeviceStatus:[
    4. {Status:UNACTIVE, DeviceName:...},
    5. {Status:UNACTIVE, DeviceName:...}
    6. ]
    7. },
    8. RequestId:"1A540BD7-176C-42D4-B3C0-A2C549DD00A3",
    9. Success:true
    10. }

    XML示例

    1. <BatchGetDeviceStateResponse>
    2. <RequestId>1AB5E6B0-AFCB-47B1-B6D4-C2BD32D63E14</RequestId>
    3. <Success>true</Success>
    4. <DeviceStatusList>
    5. <DeviceStatus>
    6. <Status>UNACTIVE</Status>
    7. <DeviceName>...</DeviceName>
    8. </DeviceStatus>
    9. <DeviceStatus>
    10. <Status>UNACTIVE</Status>
    11. <DeviceName>...</DeviceName>
    12. </DeviceStatus>
    13. </DeviceStatusList>
    14. </BatchGetDeviceStateResponse>