全部产品
Search
文档中心

阿里云物联网平台:ListAnalyticsData

更新时间:Sep 19, 2023

调用该接口执行数据服务API对应的查询任务,从而获取数据源里的指定数据。

QPS限制

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

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListAnalyticsData

系统规定参数。取值:ListAnalyticsData。

ApiPath String /iot-cn-npk1v******/system/query/hist_dev_cnt_stat

API路径。

您可在数据API的API详情页面,查看API Path的值。具体操作,请参见查看与使用

Condition.N.FieldName String testCode

对应服务API设置的请求参数名。

您可在数据API的API详情页面,查看请求参数的值。具体操作,请参见查看与使用

Condition.N.Operate String =

比较运算符。

仅支持bteqneqrlikeinnin,及其对应的操作符BETWEEN=!=LIKEINNIN

您可在数据API的API详情页面,查看请求参数的对应操作符。具体操作,请参见查看与使用

  • BETWEEN:请求参数赋值为特定范围。
  • =:请求参数赋值为特定值。
  • !=:请求参数赋值不为特定值。
  • LIKE:请求参数赋值以特定值为首。
  • IN:请求参数赋值属于特定集合。
  • NIN:请求参数赋值不属于特定集合。

例如,数据集有6条记录(对应的time分别为abcdabceabcfabcgaabcabbc),调用该接口时,Condition.N.FieldName="time"

  • 如果Condition.N.Operate="LIKE"Condition.N.Value="abc",则返回time=abcdtime=abcetime=abcftime=abcg的所有记录。
  • 如果Condition.N.Operate="IN"Condition.N.Value="[abcd,abce,abcf]",则返回time=abcdtime=abcetime=abcf的所有记录。
说明 如果该参数取值为BETWEEN,则Condition.N.BetweenStartCondition.N.BetweenEnd必传。如果该参数取值不为BETWEEN,则Condition.N.Value必传。
IotInstanceId String iot-cn-npk1u******

API所在实例的实例ID。

更多信息,请参见如何获取实例ID

IsoId String oxs_iso_id

逻辑隔离ID。请忽略该参数。

PageSize Integer 100

每页显示结果的条数。

返回结果中,每页显示的记录数量。最大取值100,最小取值1,默认取值为100。

说明 开启分页时必传。
Condition.N.Value String 4

比较值。即服务API请求参数的赋值。

您可在数据API的API详情页面,查看请求参数的赋值情况。具体操作,请参见查看与使用

说明 Condition.N.Operate取值不为BETWEENbt时,该参数必传,且不传Condition.N.BetweenStartCondition.N.BetweenEnd
Condition.N.BetweenStart String 1

服务API请求参数表示范围时的起始值。

您可在数据API的API详情页面,查看请求参数的取值范围。具体操作,请参见查看与使用

说明 Condition.N.Operate取值为BETWEENbt时,该参数必传,且不传Condition.N.Value
Condition.N.BetweenEnd String 5

服务API请求参数表示范围时的终止值。

您可在数据API的API详情页面,查看请求参数的取值范围。具体操作,请参见查看与使用

说明 Condition.N.Operate取值为BETWEENbt时,该参数必传,且不传Condition.N.Value
PageNum Integer 1

指定显示返回结果中的第几页的内容。默认值为 1。

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

返回数据

名称 类型 示例值 描述
Code String Success

接口返回码:

  • Success:表示成功。
  • 其他:表示错误,更多信息,请参见错误码
Data Struct

调用成功时,返回的数据信息。

Count Long 3

符合查询条件的记录总条数。

HasNext Boolean false

符合条件的数据是否有下一页:

  • true:有。
  • false:没有。
PageNum Integer 1

分页的页码。

PageSize Integer 100

每页显示结果的最大条数。

ResultJson String [{\"testCode\":\"TBB186\",\"testLevel\":5,\"testWorkYears\":3,\"testName\":\"王五\"},{\"testCode\":\"TBB1314\",\"testLevel\":2,\"testWorkYears\":4,\"testName\":\"李四\"},{\"testCode\":\"TBB8888\",\"testLevel\":2,\"testWorkYears\":5,\"testName\":\"熊大\"}]"

符合条件的数据详情。

ErrorMessage String insuficient auth:无访问权限

调用失败时,返回的错误信息。

RequestId String 7EC5B624-AF1B-4C4D-BA82-A02BA1******

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

Success Boolean false

表示是否调用成功:

  • true:调用成功。
  • false:调用失败。

示例

请求示例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=ListAnalyticsData
&ApiPath=/iot-cn-npk1v******/system/query/hist_dev_cnt_stat
&Condition.1.FieldName=testCode
&Condition.1.Operate==
&IotInstanceId=iot-cn-npk1u******
&<公共请求参数>

正常返回示例

XML格式

<ListAnalyticsDataResponse>
  <RequestId> 7EC5B624-AF1B-4C4D-BA82-A02BA1******</RequestId>
  <Data>
        <ResultJson>[{\"testCode\":\"TBB186\",\"testLevel\":5,\"testWorkYears\":3,\"testName\":\"王五\"},{\"testCode\":\"TBB1314\",\"testLevel\":2,\"testWorkYears\":4,\"testName\":\"李四\"},{\"testCode\":\"TBB8888\",\"testLevel\":2,\"testWorkYears\":5,\"testName\":\"熊大\"}]"</ResultJson>
        <PageSize>100</PageSize>
        <PageNum>1</PageNum>
        <Count>3</Count>
        <HasNext>false</HasNext>
  </Data>
  <Code>Success</Code>
  <Success>true</Success>
</ListAnalyticsDataResponse>

JSON格式

{
    "RequestId": "7EC5B624-AF1B-4C4D-BA82-A02BA1******",
    "Data": {
        "ResultJson": "[{\"testCode\":\"TBB186\",\"testLevel\":5,\"testWorkYears\":3,\"testName\":\"王五\"},{\"testCode\":\"TBB1314\",\"testLevel\":2,\"testWorkYears\":4,\"testName\":\"李四\"},{\"testCode\":\"TBB8888\",\"testLevel\":2,\"testWorkYears\":5,\"testName\":\"熊大\"}]",
        "PageSize": 100,
        "PageNum": 1,
        "Count": 3,
        "HasNext": false
    },
    "Code": "Success",
    "Success": true
}

错误码

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