V2.1 Search Event¶
按条件分页搜索事件。
如果你在使用 API 批量更新相关事件信息后调用当前 API,建议两次调用间隔 2 秒左右,以免获取到未更新数据。
该 API 支持在 EnOS 2.1.0 及以上环境中使用。
请求格式¶
POST https://{apigw-address}/connect-service/v2.1/events?action=search
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
必需 |
String |
资产所属的组织 ID。如何获取 orgId 信息>> |
请求参数(Body)¶
备注
以下非必需字段中,必须提供 assetId
或 productKey
+ deviceKey
的组合,用于指定设备。
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
productKey |
可选(见上述注解) |
String |
设备的 product key,需与 |
deviceKey |
可选(见上述注解) |
String |
设备的 device key,需与 |
assetId |
可选(见上述注解) |
String |
资产 ID。如何获取 assetId 信息>> |
tslEventKey |
可选 |
String |
事件 key。 |
tslEventType |
可选 |
String |
事件类型。包含信息、告警和故障。 |
startTime |
可选 |
String |
开始时间,针对事件的发生时间而言,格式 yyyy-MM-dd HH:mm:ss 代表查询本地时间,yyyy-MM-ddTHH:mm:ssZ 代表 UTC 时间,如果不填,默认最近一周的数据。 |
endTime |
可选 |
String |
结束时间,针对事件的发生时间而言,格式 yyyy-MM-dd HH:mm:ss 代表查询本地时间,yyyy-MM-ddTHH:mm:ssZ 代表 UTC 时间,如果不填,默认最近一周的数据。 |
expression |
可选 |
String |
查询表达式,支持类 SQL 的查询。目前支持查询的字段是 |
pagination |
可选 |
Pagination 请求结构体 |
分页参数。如未指定,默认每页 10 条。为获得最佳性能,建议每页不超过 50 条。不支持使用 |
resolveName |
可选 |
Boolean |
|
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
data |
Event 结构体数组 |
有关 Event 结构体的定义,见 Event 结构体。 |
Event 结构体 ¶
名称 |
数据类型 |
描述 |
---|---|---|
orgId |
String |
资产所属的组织 ID。 |
eventId |
String |
事件 ID。前往模型详情的 功能定义 页,在功能 ID 列获取 ID。 |
productKey |
String |
Product Key。 |
deviceKey |
String |
Device Key。 |
assetId |
String |
资产 ID。 |
tslEventKey |
String |
TSL 模型中的事件 Key。 |
tslEventType |
String |
TSL 模型中定义的事件类型。包含信息、告警和故障。 |
output |
String |
事件的输出。 |
outputData |
Map(Key 为 String,Value 为 Object) |
事件的输出 JSON 格式。 |
timestamp |
Long |
事件发生时间戳。 |
localtime |
String |
事件发生本地时间。 |
eventName |
StringI18n |
事件的名称。结构参见 国际化名称结构体。 |
outputNames |
Map(Key 为 String,Value 为 StringI18n) |
事件的输出名称。 |
示例¶
请求示例¶
url:https://{apigw-address}/connect-service/v2.1/events?action=search&orgId=yourOrgId
method: POST
requestBody:
{
"pagination":{
"pageNo":1,
"pageSize":2
},
"action":"search",
"resolveName":true
}
返回示例¶
{
"code": 0,
"msg": "OK",
"requestId": "7b5d3c98-27bd-435c-a8e5-ffd0c91e679f",
"data": [
{
"eventId": "2021032347372528c9dd2035cdf169f6e60c6d1a",
"orgId": "yourOrgId",
"productKey": "yourProductKey",
"deviceKey": "yourDeviceKey",
"assetId": "yourAssetId",
"tslEventKey": "yourEventKey",
"tslEventType": "INFO",
"output": "{\"breakdown\":0}",
"outputData": {
"breakdown": 0
},
"timestamp": 1616495975000,
"localtime": "2021-03-23 18:39:35",
"eventName": {
"defaultValue": "event",
"i18nValue": {}
},
"outputNames": {
"breakdown": {
"defaultValue": "breakdown",
"i18nValue": {
"en_US": "breakdown",
"zh_CN": "分解"
}
}
}
}
],
"pagination": {
"pageNo": 1,
"pageSize": 2,
"totalSize": 1
}
}
SDK 示例¶
你可以在 Github 上获取接入服务的 SDK 示例: