BatchGetDeviceState
调用该接口批量查看同一产品下指定设备的运行状态
服务地址：
华东2（上海）
输入参数
只看必填
IotInstanceId实例ID
ProductKey要查看运行状态的设备所属的产品Prod...
DeviceName要查看运行状态的设备的名称列表
0
添加
IotId要查看运行状态的设备ID列表
0
添加
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

使用说明

调用本接口时：

  • 请求参数同时传入 ProductKey 和多个 DeviceName：查询同一产品多个设备的运行状态。
  • 请求参数传入多个 IotId：可传入不同产品下设备的 IotId，查询不同产品下设备的运行状态。

注意 单次调用本接口最多可查询 50 个设备的运行状态。

QPS 限制

单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为 50。

说明 单个阿里云账号下的所有 RAM 用户共享该阿里云账号的配额。

请求参数

字段名称字段详情
IotInstanceIdstring

实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。展开详情

示例值:iot_instc_pu****_c*-v64********
ProductKeystring

要查看运行状态的设备所属的产品 ProductKey。展开详情

示例值:a1BwAGV****参考取值来源:
    CreateProduct
    QueryProductList
    ReleaseProduct
    ListProductByTags
    BindLicenseProduct
    BatchBindProductsIntoProject
DeviceNamearray<string>

要查看运行状态的设备的名称列表。展开详情

示例值:light子级条数 <= 51
IotIdarray<string>

要查看运行状态的设备 ID 列表。展开详情

示例值:Q7uOhVRdZRRlDnTLv****00100子级条数 <= 51

请求说明

调用 API 时，除了本文介绍的该 API 的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。

返回参数

字段名称字段详情
Codestring

调用失败时，返回的错误码。更多信息，请参见错误码。

示例值:iot.system.SystemException
ErrorMessagestring

调用失败时，返回的出错信息。

示例值:系统异常
RequestIdstring

阿里云为该请求生成的唯一标识符。

示例值:E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565
Successboolean

是否调用成功。展开详情

示例值:true
DeviceStatusListobject
变更历史
暂无变更历史