调用该接口分页查询所有规则列表。
QPS限制
单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为20。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListRule | 系统规定参数。取值:ListRule。 |
CurrentPage | Integer | 是 | 1 | 显示返回结果中的第几页。最大取值为1000,默认值为1。 |
PageSize | Integer | 是 | 2 | 返回结果中每页显示的记录数量。最大值为100,默认值为10。 |
IotInstanceId | String | 否 | iot_instc_pu****_c*-v64******** | 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。 重要
实例的更多信息,请参见实例概述。 |
ResourceGroupId | String | 否 | rg-acfmxazb4ph**** | 资源组ID。 重要 目前,物联网平台仅支持实例维度的资源组管理。请求参数ResourceGroupId配置已无效,无需再传入。
|
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | iot.system.SystemException | 调用失败时,返回的错误码。更多信息,请参见错误码。 |
Data | Array of RuleInfo | 调用成功时,返回的规则信息列表。详情参见RuleInfo信息。 说明 返回规则信息按照规则创建时间倒序排列。 |
|
RuleInfo | |||
CreateUserId | Long | 1231579085000000 | 创建该规则的用户ID。 |
Created | String | Wed Feb 27 20:45:43 CST 2019 | 该规则创建时的CST(Central Standard Time)时间。 |
DataType | String | JSON | 该规则的数据类型,取值:JSON和BINARY。 |
Id | Long | 151454 | 规则ID。 |
Modified | String | Wed Feb 27 20:45:43 CST 2019 | 该规则最近一次被修改时的CST (Central Standard Time)时间。 |
Name | String | test123 | 规则名称。 |
ProductKey | String | a1KiV****** | 应用该规则的产品Productkey。 |
RuleDesc | String | rule1Desc | 规则的描述信息。 |
Select | String | deviceName() as deviceName | 该规则SQL语句中的Select内容。 |
ShortTopic | String | +/thing/event/property/post | 应用该规则的具体Topic(不包含ProductKey类目),格式为: |
Status | String | STOP | 该规则的运行状态。取值:
|
Topic | String | /a1T27vz****/+/thing/event/property/post | 应用该规则的具体Topic,格式为: |
UtcCreated | String | 2019-02-27T12:40:43.000Z | 该规则创建时的UTC时间。 |
UtcModified | String | 2019-02-27T12:45:43.000Z | 该规则最近一次被修改时的UTC时间。 |
Where | String | Temperature>35 | 该规则SQL语句中的Where查询条件。 |
ErrorMessage | String | 系统异常 | 调用失败时,返回的出错信息。 |
Page | Integer | 1 | 当前页码。 |
PageSize | Integer | 2 | 每页显示的记录数。 |
RequestId | String | 1564B626-DE97-452D-9E9B-305888AC6105 | 阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true | 是否调用成功。
|
Total | Integer | 25 | 总页数。 |
示例
请求示例
https://iot.cn-shanghai.aliyuncs.com/?Action=ListRule
&PageSize=2
&CurrentPage=1
&<公共请求参数>
正常返回示例
XML
格式
<ListRuleResponse>
<Data>
<RuleInfo>
<DataType>JSON</DataType>
<ProductKey>a1T27vz****</ProductKey>
<CreateUserId>198426864326****</CreateUserId>
<UtcModified>2020-02-26T06:38:27.000Z</UtcModified>
<UtcCreated>2020-02-26T02:50:44.000Z</UtcCreated>
<Where>Temperature>35</Where>
<Name>testrule2</Name>
<Status>STOP</Status>
<Select>deviceName() as DeviceName</Select>
<Created>Wed Feb 26 10:50:44 CST 2020</Created>
<Modified>Wed Feb 26 14:38:27 CST 2020</Modified>
<Topic>/a1T27vz****/+/thing/event/property/post</Topic>
<Id>497350</Id>
</RuleInfo>
</Data>
<Page>1</Page>
<PageSize>1</PageSize>
<RequestId>1A6131EC-7504-4673-B997-DEFC6B363A37</RequestId>
<Success>true</Success>
<Total>5</Total>
</ListRuleResponse>
JSON
格式
{
"Data": {
"RuleInfo": [
{
"DataType": "JSON",
"ProductKey": "a1T27vz****",
"CreateUserId": "198426864326****",
"UtcModified": "2020-02-26T06:38:27.000Z",
"UtcCreated": "2020-02-26T02:50:44.000Z",
"Where": "Temperature>35",
"Name": "testrule2",
"Status": "STOP",
"Select": "deviceName() as DeviceName",
"Created": "Wed Feb 26 10:50:44 CST 2020",
"Modified": "Wed Feb 26 14:38:27 CST 2020",
"Topic": "/a1T27vz****/+/thing/event/property/post",
"Id": 497350
}
]
},
"Page": 1,
"PageSize": 1,
"RequestId": "1A6131EC-7504-4673-B997-DEFC6B363A37",
"Success": true,
"Total": 5
}