查询设备批量注册的记录信息-阿里云帮助中心

QPS限制

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

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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	QueryGenerateDevicesRecord	系统规定参数。取值：QueryGenerateDevicesRecord。
StartTime	Long	是	1690819200000	起始时间的毫秒级时间戳。
EndTime	Long	是	1659283200000	结束时间的毫秒级时间戳。重要起止时间间隔不能超过30天。
PageSize	Integer	是	1	指定返回结果中每页显示的记录数量，最大值是100。
PageNo	Integer	是	1	指定显示返回结果中的第几页，最大值为1,000。

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

返回数据

名称	类型	示例值	描述
Code	String	400	调用结果状态码：调用成功，返回200。调用失败，返回错误码。详细信息，请参见下文错误码。
Data	Struct		调用成功，返回的结果。
ListData	Array of GenerateDeviceRecordDTO		设备注册记录的详细信息。
ApplyDeviceCount	Long	133	申请的设备数量。
BatchId	String	1508******195	申请的批次ID。
BatchStatus	String	CREATE	批量注册的批次状态。 CREATE：正在创建设备。 CREATE_SUCCESS：申请单中的所有设备创建成功。 CREATE_FAILED：申请单中有设备创建失败。
CreateTime	Long	1690819200000	批量注册设备任务的提交时间，格式为毫秒级时间戳。
NetworkType	String	WIFI	产品的连网方式。取值： WIFI：Wi-Fi。 CELLULAR：蜂窝GPRS/3G/4G/5G。 ETHERNET：以太网。 OTHER：其他网络类型。
OperateUid	Long	110000000000	操作账号的UID。
ProductKey	String	a3w******	设备所属产品的ProductKey。
ProductName	String	电饭煲	设备所属产品的名称。
SpecCode	String	Consumer_IPC_512Kbps	激活码规格Code。取值： Consumer_IPC_512Kbps：消费类IPC 512Kbps。 Consumer_IPC_1Mbps：消费类IPC 1Mbps。 Consumer_IPC_2Mbps：消费类IPC 2Mbps。 Consumer_IPC_4Mbps：消费类IPC 4Mbps。 Industry_IPC：行业类IPC。 NVR_Less64：NVR小于等于64路。 NVR_Higher64：NVR大于64路。
SuccessCount	Long	5	批量注册设备成功的设备数量。
PageNo	Integer	1	当前页码。
PageSize	Integer	1	每页显示的记录数。
Total	Integer	5	总记录数。
ErrorMessage	String	Request parameter error.	调用失败时，返回的出错信息。
RequestId	String	E5****-4-B-8E-D3********65	阿里云为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功。 false：调用失败。

示例

请求示例

http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=QueryGenerateDevicesRecord
&StartTime=1690819200000
&EndTime=1659283200000
&PageSize=1
&PageNo=1
&<公共请求参数>

正常返回示例

XML格式

<QueryGenerateDevicesRecordResponse>
  <RequestId>E5******-4***-***B-8**E-D3********65</RequestId>
  <Data>
        <PageSize>1</PageSize>
        <Total>5</Total>
        <PageNo>1</PageNo>
        <ListData>
              <SpecCode>Consumer_IPC_512Kbps</SpecCode>
              <OperateUid>110000000000</OperateUid>
              <ProductName>电饭煲</ProductName>
              <NetworkType>WIFI</NetworkType>
              <BatchStatus>CREATE</BatchStatus>
              <CreateTime>1690819200000</CreateTime>
              <BatchId>1508******195</BatchId>
              <SuccessCount>5</SuccessCount>
              <ProductKey>a3w******</ProductKey>
              <ApplyDeviceCount>133</ApplyDeviceCount>
        </ListData>
  </Data>
  <Code>200</Code>
  <Success>true</Success>
</QueryGenerateDevicesRecordResponse>

JSON格式

{
    "RequestId": "E5******-4***-***B-8**E-D3********65",
    "Data": {
        "PageSize": 1,
        "Total": 5,
        "PageNo": 1,
        "ListData": [{
            "SpecCode": "Consumer_IPC_512Kbps",
            "OperateUid": 110000000000,
            "ProductName": "电饭煲",
            "NetworkType": "WIFI",
            "BatchStatus": "CREATE",
            "CreateTime": 1690819200000,
            "BatchId": "1508******195",
            "SuccessCount": 5,
            "ProductKey": "a3w******",
            "ApplyDeviceCount": 133
        }]
    },
    "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.	未知内部错误。

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