QueryBatchRegisterDeviceStatus_物联网平台_API文档-阿里云OpenAPI开发者门户

接口说明

批量注册设备时，可调用本接口根据申请批次 ID（ApplyId），查看设备名称校验结果或注册结果。

使用自定义设备名称批量注册设备时，必须先调用本接口确保自定义设备名称全部校验通过，再调用 BatchRegisterDeviceWithApplyId 接口根据对应申请批次 ID 完成设备注册。

说明

如果有校验失败的设备名称，请根据错误信息提示进行修正，然后重新调用 BatchCheckDeviceNames 接口获取新的申请批次 ID（ApplyId）后，再次调用 QueryBatchRegisterDeviceStatus 接口确认全部设备名称校验通过。

如果返回的 Status 为 CHECK，请耐心等待。批量注册设备有一个过程，您可再次调用本接口查看 Status 确认全部设备名称校验通过。

使用自定义设备名称批量注册设备的完整流程，请参见 BatchCheckDeviceNames 的使用说明。

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

说明 RAM 用户共享阿里云账号配额。

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

iot:QueryBatchRegisterDeviceStatus	Get	全部资源 *	无	无

字段名称	字段详情
IotInstanceIdstring	实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。展开详情示例值:iot_instc_pu***_c-v64********
ProductKeystring	要查询的设备所属的产品 ProductKey。示例值:a1BwAGV****参考取值来源: CreateProduct QueryProductList ReleaseProduct ListProductByTags BindLicenseProduct BatchBindProductsIntoProject
ApplyIdinteger<int64>	要查询的申请批次 ID。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:1295006

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

字段名称	字段详情
Codestring	调用失败时，返回的错误码。更多信息，请参见错误码。展开详情示例值:iot.system.SystemException
ErrorMessagestring	调用失败时，返回的出错信息。示例值:系统异常
RequestIdstring	阿里云为该请求生成的唯一标识符。示例值:E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565
Successboolean	表示是否调用成功。展开详情示例值:true
Dataobject	调用成功时，返回的状态信息。

暂无变更历史