日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 物聯網平臺 開發參考 云端開發指南 云端API參考 物模型使用 QueryDevicePropertiesData

QueryDevicePropertiesData

更新時間：
產品詳情
我的收藏

調用該接口查詢指定設備或數字孿生節點，在指定時間段內，多個屬性的數據。

使用說明

  • 若查詢數字孿生節點的屬性數據，必須傳入參數IotId，且取值為孿生節點ID。
  • 目前本接口已不支持分頁查詢。調用本接口時，如果在指定時間段內，沒有返回PageSize條記錄，返回的NextTime和NextValid也是無效的。您可多次調用接口QueryDevicePropertyData，一次輸入一個Identifier進行查詢。

使用限制

  • 一次調用下，最多查詢10個屬性的歷史數據，最多返回100條數據。
  • 標準型和尊享型企業版實例：僅可查詢存儲時效內的數據。數據存儲時效，請參見存儲配置。
  • 其他實例：僅可查詢最近30天內的屬性數據。

QPS限制

單個阿里云賬號調用該接口的每秒請求數（QPS）最大限制為10。

說明 單個阿里云賬號下的所有RAM用戶共享該阿里云賬號的配額。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱

類型

是否必選

示例值

描述
Action String 是 QueryDevicePropertiesData

系統規定參數。取值：QueryDevicePropertiesData。
Asc Integer 是 0

返回結果中，屬性記錄按時間排序的方式。取值：

  • 0：倒序。倒序查詢時，StartTime必須大于EndTime。
  • 1：正序。正序查詢時，StartTime必須小于EndTime。
EndTime Long 是 1579249499000

屬性記錄的結束時間。取值為13位毫秒值時間戳，例如：1579249499000。
Identifier.N RepeatList 是 temperature

屬性的標識符列表。

不可輸入重復的屬性Identifier。

  • 設備的屬性Identifier，可在物聯網平臺控制臺中設備所屬的產品的功能定義中查看，或調用QueryThingModel，從返回的物模型數據中查看。
  • 數字孿生節點的屬性Identifier，可在物聯網平臺控制臺的數字孿生工作臺下的孿生節點的功能屬性中查看。具體操作，請參見孿生節點的功能屬性。
說明 如果設備的屬性是自定義（非默認）模塊testFb下屬性temperature，則參數值為testFb:temperature。
PageSize Integer 是 10

單個屬性可返回的數據記錄數量。最大值為100。

任意一個屬性返回的數據記錄數量不超過該值。
StartTime Long 是 1579249499000

屬性記錄的開始時間。取值為13位毫秒值時間戳，例如：1579249499000。
IotInstanceId String 否 iot_instc_pu****_c*-v64********

實例ID。您可在物聯網平臺控制臺的實例概覽頁面，查看當前實例的ID。

重要
  • 若有ID值，必須傳入該ID值，否則調用會失敗。
  • 若無ID值，則無需傳入。

實例的更多信息，請參見實例概述。
ProductKey String 否 a1BwAGV****

要查詢設備所屬的產品ProductKey。

重要

如果傳入該參數，需同時傳入DeviceName。
DeviceName String 否 airconditioning

要查詢的設備名稱。

重要

如果傳入該參數，需同時傳入ProductKey。
IotId String 否 Q7uOhVRdZRRlDnTLv****00100

要查詢屬性所屬的設備ID或數字孿生節點ID：

  • 調用QueryDeviceInfo接口，可查詢指定設備的IotId。
  • 在物聯網平臺控制臺的數字孿生體詳情頁面，單擊孿生節點，可查看節點ID。
重要 IotId作為設備唯一標識符，和ProductKey與DeviceName組合是一一對應的關系。如果傳入該參數，則無需傳入ProductKey和DeviceName。如果您同時傳入IotId和ProductKey與DeviceName組合，則以IotId為準。

調用API時，除了本文介紹的該API的特有請求參數，還需傳入公共請求參數。公共請求參數說明，請參見公共參數文檔。

返回數據

名稱

類型

示例值

描述
Code String iot.system.SystemException

調用失敗時，返回的錯誤碼。更多信息，請參見錯誤碼。
ErrorMessage String 系統異常

調用失敗時，返回的出錯信息。
NextTime Long 1579249499000

目前本接口不支持分頁查詢，請忽略此參數返回值。
NextValid Boolean true

目前本接口不支持分頁查詢，請忽略此參數返回值。
PropertyDataInfos Array of PropertyDataInfo

調用成功時，返回的屬性信息列表（PropertyDataInfo）。
PropertyDataInfo
Identifier String temperature

屬性的標識符。
List Array of PropertyInfo

屬性數據列表。
PropertyInfo
Time Long 1579249499000

屬性上報時間。取值為毫秒值時間戳，例如：1579249499000。
Value String 21.3

屬性值。
RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

阿里云為該請求生成的唯一標識符。
Success Boolean true

表示是否調用成功。

  • true：調用成功。
  • false：調用失敗。

示例

請求示例

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDevicePropertiesData
&Asc=0
&DeviceName=water
&EndTime=1540115948152
&Identifier.1=Temperature
&Identifier.2=Humidity
&PageSize=100
&ProductKey=a1bd***
&StartTime=1540116010723
&<公共請求參數>

正常返回示例

XML格式

<QueryDevicePropertiesData>
  <NextValid>false</NextValid>
  <RequestId>CC4CAC00-ED4C-4004-9E8D-E8B4A78552FA</RequestId>
  <PropertyDataInfos>
        <PropertyDataInfo>
              <List>
                    <PropertyInfo>
                          <Value>32.46</Value>
                          <Time>1579249151178</Time>
                    </PropertyInfo>
              </List>
              <Identifier>Temperature</Identifier>
        </PropertyDataInfo>
        <PropertyDataInfo>
              <List>
                    <PropertyInfo>
                          <Value>48</Value>
                          <Time>1579249151178</Time>
                    </PropertyInfo>
              </List>
              <Identifier>Humidity</Identifier>
        </PropertyDataInfo>
  </PropertyDataInfos>
  <Success>true</Success>
</QueryDevicePropertiesData>

JSON格式

{
  "NextValid": false, 
  "RequestId": "CC4CAC00-ED4C-4004-9E8D-E8B4A78552FA", 
  "PropertyDataInfos": {
    "PropertyDataInfo": [
      {
        "List": {
          "PropertyInfo": [
            {
              "Value": "32.46", 
              "Time": 1579249151178
            }
          ]
        }, 
        "Identifier": "Temperature"
      }, 
      {
        "List": {
          "PropertyInfo": [
            {
              "Value": "48", 
              "Time": 1579249151178
            }
          ]
        }, 
        "Identifier": "Humidity"
      }
    ]
  }, 
  "Success": true
}