调用该接口查询指定设备本身调用的原始服务(通过和未通过物模型校验的所有服务)记录。
使用说明
仅可查询最近30天内的服务数据。
QPS限制
单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为50。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryDeviceOriginalServiceData | 系统规定参数。取值:QueryDeviceOriginalServiceData。 |
Asc | Integer | 是 | 0 | 指定返回结果中,服务调用记录按时间排序的方式。取值:
说明 StartTime必须小于EndTime,系统会根据排序方式自动转换。 |
EndTime | Long | 是 | 1579249499000 | 要查询的服务调用记录的结束时间。取值为毫秒值时间戳。 |
Identifier | String | 是 | Set | 要查询的服务标识符。
|
PageSize | Integer | 是 | 10 | 返回结果中每页显示的记录数。数量限制:每页最多可显示50条。 |
StartTime | Long | 是 | 1579249498000 | 要查询的服务调用记录的开始时间。取值为毫秒值时间戳。 |
IotInstanceId | String | 否 | iot_instc_pu****_c*-v64******** | 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。 重要
实例的更多信息,请参见实例概述。 |
ProductKey | String | 否 | a1BwAGV**** | 要查询设备所属的产品ProductKey。 重要 如果传入该参数,需同时传入DeviceName。
|
DeviceName | String | 否 | light | 要查询的设备名称。 重要 如果传入该参数,需同时传入ProductKey。
|
NextPageToken | String | 否 | Bo***x44Qx | 下一页标识。第一次请求,服务会返回此Token,第二次请求带上即可。 |
IotId | String | 否 | Q7uOhVRdZRRlDnTLv****00100 | 要查询的设备ID。物联网平台为该设备颁发的ID,设备的唯一标识符。 重要 IotId作为设备唯一标识符,和ProductKey与DeviceName组合是一一对应的关系。如果传入该参数,则无需传入ProductKey和DeviceName。如果您同时传入IotId和ProductKey与DeviceName组合,则以IotId为准。
|
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | iot.device.InvalidIoTId | 调用失败时,返回的错误码。更多信息,请参见错误码。 |
Data | Struct | 调用成功时,返回的设备服务调用记录。 |
|
List | Array of ServiceInfo | 服务调用记录集合。每个元素代表一个服务调用记录。服务信息请参见ServiceInfo下参数。 |
|
ServiceInfo | |||
Identifier | String | Set | 服务标识符。 |
InputData | String | {\"LightAdjustLevel\":123} | 服务的输入参数,MAP格式的字符串,结构为 |
Name | String | 设置温度 | 服务名称。 |
OutputData | String | {\"code\":200,\"data\":{},\"id\":\"100686\",\"message\":\"success\",\"version\":\"1.0\"} | 服务的输出参数,MAP格式的字符串,结构为 |
Time | String | 1579249499000 | 调用服务的时间。 |
NextPageToken | String | Bo***x44Qx | 下一页标识。 |
NextValid | Boolean | true | 是否有下一页属性记录。
返回NextValid为true时,可以将NextPageToken的值作为下次查询的NextPageToken,继续查询本次查询不显示的数据。 |
ErrorMessage | String | 系统异常 | 调用失败时,返回的出错信息。 |
RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | 阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true | 是否调用成功。
|
示例
请求示例
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceOriginalServiceData
&Asc=0
&EndTime=1579249499000
&Identifier=Set
&PageSize=10
&StartTime=1579249498000
&<公共请求参数>
正常返回示例
XML
格式
<QueryDeviceOriginalServiceDataResponse>
<Data>
<NextValid>true</NextValid>
<NextPageToken>Bo***x44Qx</NextPageToken>
<List>
<ServiceInfo>
<Name>set</Name>
<Time>1517315865198</Time>
<OutputData>{"code":200,"data":{},"id":"100686","message":"success","version":"1.0"}</OutputData>
<InputData>{"LightAdjustLevel":123}</InputData>
<Identifier>set</Identifier>
</ServiceInfo>
</List>
</Data>
<RequestId>A44C818E-FA7F-4765-B1E7-01D14AE01C6A</RequestId>
<Success>true</Success>
</QueryDeviceOriginalServiceDataResponse>
JSON
格式
{
"Data": {
"NextValid": true,
"NextPageToken": "Bo***x44Qx",
"List": {
"ServiceInfo": [
{
"Name": "set",
"Time": 1517315865198,
"OutputData": "{\"code\":200,\"data\":{},\"id\":\"100686\",\"message\":\"success\",\"version\":\"1.0\"}",
"InputData": "{\"LightAdjustLevel\":123}",
"Identifier": "set"
}
]
}
},
"RequestId": "A44C818E-FA7F-4765-B1E7-01D14AE01C6A",
"Success": true
}
错误码
访问错误中心查看更多错误码。