直接批量注册设备-阿里云帮助中心_(LinkVisual)-阿里云帮助中心

使用说明

批量注册设备有两种方式：

由系统随机生成设备名称：调用本接口。

建议按照以下流程注册设备和查看结果。

1. 调用本接口批量注册设备。返回成功结果，表示批量注册的申请已经提交成功。实际的注册是异步执行，会有一个过程。

2. 调用接口QueryBatchStatus，根据申请批ID查看设备注册状态。

3. 调用接口QueryGenerateDevicesInfoList，查看批量注册的设备信息。或者调用QueryDevicesDownloadUrl，查询批量注册设备信息的转储OSS文件地址。
自定义设备名称：请参见GenerateDeviceByBatchId。

QPS限制

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

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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	GenerateDevice	系统规定参数。取值：GenerateDevice。
ProjectId	String	是	a123qs*****sy4QU	项目ID。
ProductKey	String	是	a3W*****	设备所属产品的ProductKey。
Amount	Long	是	12	待注册的设备数量，取值范围为1~10,000。说明未发布上线的产品下，单次最多注册2,000个设备。

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

返回数据

名称	类型	示例值	描述
Code	String	400	调用结果状态码：调用成功，返回200。调用失败，返回错误码。详细信息，请参见下文错误码。
Data	Struct		调用成功，返回的结果。
BatchId	String	1508******195	批量注册设备，返回的申请批次ID。
ErrorMessage	String	Active code quota is insufficient.	调用失败时，返回的出错信息。
RequestId	String	E5****-4-B-8E-D3********65	阿里云为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功。 false：调用失败。

示例

请求示例

http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=GenerateDevice
&ProjectId=a123qs*****sy4QU
&ProductKey=a3W*****
&Amount=12
&<公共请求参数>

正常返回示例

XML格式

<GenerateDeviceResponse>
  <RequestId>E5******-4***-***B-8**E-D3********65</RequestId>
  <Data>
        <BatchId>1508******195</BatchId>
  </Data>
  <Code>200</Code>
  <Success>true</Success>
</GenerateDeviceResponse>

JSON格式

{
    "RequestId": "E5******-4***-***B-8**E-D3********65",
    "Data": {
        "BatchId": "1508******195"
    },
    "Code": 200,
    "Success": true
}

错误码

HttpCode	错误码	错误信息	描述
400	iot.vision.RequestParamError	Request parameter error.	请求参数错误。
403	iot.vision.RequestAuthFailed	Request auth failed.	请求鉴权失败。
403	iot.vision.RequestForbidden	Request forbidden.	请求被禁止。
429	iot.vision.RequestTrafficControl	Request traffic control.	请求太频繁被限流。
400	iot.vision.UnexpectedInternalError	Unexpected internal error.	未知内部错误。
400	iot.vision.ActiveCodeInsufficient	Active code quota is insufficient.	可用激活码不足。
400	iot.vision.DevicesCountExceedLimit	The devices count exceed the limit.	创建设备数量超过限制。
400	iot.vision.DevicesExceedUnreleasedProductLimit	Devices count exceed the limit of unreleased product.	创建设备数量超过未发布产品的试产设备数量。

访问错误中心查看更多错误码。