IoT Platform:QueryDevicePropertiesData

Limits

• A maximum of 10 properties can be queried at a time. A maximum of 100 records can be queried for each property.
• You can query property data that is generated within the last 30 days.

  Note The storage period of a property record is calculated from the day when the property record was generated.
• Each Alibaba Cloud account can run a maximum of 10 queries per second (QPS).

  Note RAM users of an Alibaba Cloud account share the quota of the account.

Usage notes

When you call this operation to query property records within a specified period, the number of records for a property at a point in time may reach the limit. The limit is specified by the PageSize parameter. In this case, the query stops. Some records of other properties may be not returned. You can check whether all records of a property are returned based on the NextValid repsonse parameter:

• If the value of the NextValid parameter is true, unretrieved records exist in the period that is indicated by the NextTime and EndTime parameter.

  You can use the value of the NextTime response parameter as the value of the StartTime request parameter and call this operation again to query the rest records. You can call this operation multiple times until the value of the NextValid parameter is false.

  Note To retrieve all property records within a specified period, you can set the PageSize parameter to the maximum value. Then, call this operation multiple times until the value of the NextValid parameter is false.
• If the value of the NextValid parameter is false, all property records are returned.

Request parameters

In addition to the preceding operation-specific request parameters, you must specify common request parameters when you call this operation. For more information, see Common request parameters.

Response parameters

Examples

Sample requests

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
&<Common request parameters>

Sample success responses

XML format

<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 format

{
  "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
}

Error codes

For a list of error codes, visit the API Error Center.