QueryDeviceOriginalPropertyData
調(diào)用該接口查詢(xún)指定設(shè)備本身上報(bào)的原始屬性(通過(guò)和未通過(guò)物模型校驗(yàn)的所有屬性)記錄。
使用說(shuō)明
- 華東2(上海)、華北2(北京)和華南1(深圳)地域的標(biāo)準(zhǔn)型和尊享型企業(yè)版實(shí)例:僅可查詢(xún)存儲(chǔ)時(shí)效內(nèi)的數(shù)據(jù)。數(shù)據(jù)存儲(chǔ)時(shí)效,請(qǐng)參見(jiàn)存儲(chǔ)配置。
- 其他地域和實(shí)例:僅可查詢(xún)最近30天內(nèi)的原始屬性數(shù)據(jù)。
QPS限制
單阿里云賬號(hào)調(diào)用該接口的每秒請(qǐng)求數(shù)(QPS)最大限制為50。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱(chēng) |
類(lèi)型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | QueryDeviceOriginalPropertyData | 系統(tǒng)規(guī)定參數(shù)。取值:QueryDeviceOriginalPropertyData。 |
Asc | Integer | 是 | 0 | 返回結(jié)果中,屬性記錄按時(shí)間排序的方式。取值:
說(shuō)明 StartTime必須小于EndTime,系統(tǒng)會(huì)根據(jù)排序方式自動(dòng)轉(zhuǎn)換。 |
EndTime | Long | 是 | 1579249499000 | 屬性記錄的結(jié)束時(shí)間。取值為13位毫秒值時(shí)間戳。 |
Identifier | String | 是 | temperature | 屬性的標(biāo)識(shí)符。
|
PageSize | Integer | 是 | 10 | 單個(gè)屬性可返回的數(shù)據(jù)記錄數(shù)量。最大值為100。 任意一個(gè)屬性返回的數(shù)據(jù)記錄數(shù)量不超過(guò)該值。 |
StartTime | Long | 是 | 1569249488000 | 要查詢(xún)的屬性記錄的開(kāi)始時(shí)間。取值為毫秒值時(shí)間戳。 |
IotInstanceId | String | 否 | iot_instc_pu****_c*-v64******** | 實(shí)例ID。您可在物聯(lián)網(wǎng)平臺(tái)控制臺(tái)的實(shí)例概覽頁(yè)面,查看當(dāng)前實(shí)例的ID。 重要
實(shí)例的更多信息,請(qǐng)參見(jiàn)實(shí)例概述。 |
ProductKey | String | 否 | a1BwAGV**** | 要查詢(xún)?cè)O(shè)備所屬的產(chǎn)品ProductKey。 重要 如果傳入該參數(shù),需同時(shí)傳入DeviceName。
|
DeviceName | String | 否 | light | 要查詢(xún)的設(shè)備名稱(chēng)。 重要 如果傳入該參數(shù),需同時(shí)傳入ProductKey。
|
NextPageToken | String | 否 | Bo***x44Qx | 下一頁(yè)標(biāo)識(shí)。如果存在下一頁(yè),服務(wù)會(huì)返回此token,下次請(qǐng)求帶上即可。 |
IotId | String | 否 | Q7uOhVRdZRRlDnTLv****00100 | 要查詢(xún)的設(shè)備ID。物聯(lián)網(wǎng)平臺(tái)為該設(shè)備頒發(fā)的ID,設(shè)備的唯一標(biāo)識(shí)符。 重要 IotId作為設(shè)備唯一標(biāo)識(shí)符,和ProductKey與DeviceName組合是一一對(duì)應(yīng)的關(guān)系。如果傳入該參數(shù),則無(wú)需傳入ProductKey和DeviceName。如果您同時(shí)傳入IotId和ProductKey與DeviceName組合,則以IotId為準(zhǔn)。
|
調(diào)用API時(shí),除了本文介紹的該API的特有請(qǐng)求參數(shù),還需傳入公共請(qǐng)求參數(shù)。公共請(qǐng)求參數(shù)說(shuō)明,請(qǐng)參見(jiàn)公共參數(shù)文檔。
返回?cái)?shù)據(jù)
名稱(chēng) |
類(lèi)型 |
示例值 |
描述 |
Code | String | iot.device.InvalidIoTId | 調(diào)用失敗時(shí),返回的錯(cuò)誤碼。更多信息,請(qǐng)參見(jiàn)錯(cuò)誤碼。 |
Data | Struct | 調(diào)用成功時(shí),返回的設(shè)備屬性記錄。 |
|
List | Array of PropertyInfo | 屬性集合。每個(gè)元素代表一個(gè)屬性。 |
|
PropertyInfo | |||
Time | String | 1516541885630 | 屬性修改時(shí)間。 |
Value | String | {\"data\":32.49} | 屬性值。 |
NextValid | Boolean | true | 是否有下一頁(yè)屬性記錄。
返回NextValid為true時(shí),可以將NextPageToken的值作為下次查詢(xún)的NextPageToken,繼續(xù)查詢(xún)本次查詢(xún)不顯示的數(shù)據(jù)。 |
nextPageToken | String | Bo***x44Qx | 下一頁(yè)標(biāo)識(shí)。 |
ErrorMessage | String | 系統(tǒng)異常 | 調(diào)用失敗時(shí),返回的出錯(cuò)信息。 |
RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | 阿里云為該請(qǐng)求生成的唯一標(biāo)識(shí)符。 |
Success | Boolean | true | 是否調(diào)用成功。
|
示例
請(qǐng)求示例
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceOriginalPropertyData
&Asc=0
&EndTime=1579249499000
&Identifier=temperature
&PageSize=10
&StartTime=1569249488000
&IotId=Q7uOhVRdZRRlDnTLv****00100
&<公共請(qǐng)求參數(shù)>
正常返回示例
XML
格式
<QueryDeviceOriginalPropertyDataResponse>
<RequestId>DD8EE383-F007-5647-8B6B-0C52FAC3E7F2</RequestId>
<Data>
<NextValid>true</NextValid>
<nextPageToken>MTcxMjc0N***********</nextPageToken>
<List>
<PropertyInfo>
<Value>{"data":31.26}</Value>
<Time>1712747043556</Time>
</PropertyInfo>
<PropertyInfo>
<Value>{"data":32.43}</Value>
<Time>1712747043108</Time>
</PropertyInfo>
<PropertyInfo>
<Value>{"data":30.58}</Value>
<Time>1712747042619</Time>
</PropertyInfo>
<PropertyInfo>
<Value>{"data":32.49}</Value>
<Time>1712747042182</Time>
</PropertyInfo>
<PropertyInfo>
<Value>{"data":30.66}</Value>
<Time>1712747041731</Time>
</PropertyInfo>
</List>
</Data>
<Code></Code>
<Success>true</Success>
</QueryDeviceOriginalPropertyDataResponse>
JSON
格式
{
"RequestId": "DD8EE383-F007-5647-8B6B-0C52FAC3E7F2",
"Data": {
"NextValid": true,
"nextPageToken": "MTcxMjc0N***********",
"List": {
"PropertyInfo": [
{
"Value": "{\"data\":31.26}",
"Time": 1712747043556
},
{
"Value": "{\"data\":32.43}",
"Time": 1712747043108
},
{
"Value": "{\"data\":30.58}",
"Time": 1712747042619
},
{
"Value": "{\"data\":32.49}",
"Time": 1712747042182
},
{
"Value": "{\"data\":30.66}",
"Time": 1712747041731
}
]
}
},
"Code": "",
"Success": true
}