IoT Platform:QueryDevicePropertiesData

制限

• 一度に最大 10 個のプロパティをクエリできます。各プロパティについて、最大 100 レコードをクエリできます。
• 過去 30 日以内に生成されたプロパティデータをクエリできます。

  説明 プロパティレコードの保存期間は、プロパティレコードが生成された日から計算されます。
• 各 Alibaba Cloud アカウントは、最大 10 クエリ/秒（QPS）を実行できます。

  説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。

使用上の注意

この操作を呼び出して指定された期間内のプロパティレコードをクエリする場合、ある時点でのプロパティのレコード数が制限に達する可能性があります。制限は、PageSize パラメータで指定されます。この場合、クエリは停止します。他のプロパティの一部のレコードが返されない場合があります。 NextValid レスポンスパラメータに基づいて、プロパティのすべてのレコードが返されたかどうかを確認できます。

• NextValid パラメータの値が true の場合、 パラメータと パラメータで示される期間に、取得されていないレコードが存在します。次回 および 終了時刻 パラメーター。

  使用できます 次回レスポンスパラメータを StartTime リクエストパラメータの値として使用し、この操作を再度呼び出して残りのレコードをクエリします。 この操作は、NextValidは false です。

  説明 指定された期間内のすべてのプロパティレコードを取得するには、 パラメータを最大値に設定します。そして、 パラメータの値が false になるまで、この操作を複数回呼び出します。ページサイズ パラメーターを最大値に設定します。次に、この操作を、 の値が NextValidは false です。
• NextValid パラメータの値が 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
}

エラーコード

エラーコードの一覧については、API エラーセンター をご参照ください。