QueryDeviceOriginalPropertyData - IoT Platform - Alibaba Cloud ドキュメントセンター

指定されたデバイスによって送信された元のプロパティレコードをクエリします。これらのレコードには、指定された Thing Specification Language（TSL）モデルの検証に合格したプロパティと失敗したプロパティのレコードが含まれます。

使用方法

過去 30 日以内に生成されたプロパティレコードのみをクエリできます。

説明

プロパティのデータは、データが生成された日から保存されます。

QPS 制限

この API 操作は、アカウントごとに 1 秒あたり最大 50 回呼び出すことができます。

説明

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

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	はい	QueryDeviceOriginalPropertyData	実行する操作。値を QueryDeviceOriginalPropertyData に設定します。
Asc	Integer	はい	0	返されるプロパティレコードをソートする順序。有効値： 0：降順。 1：昇順。説明開始時刻は終了時刻より前でなければなりません。システムは、指定された順序に基づいて返されたレコードをソートします。
EndTime	Long	はい	1579249499000	クエリする時間範囲の終了。値は 13 桁のタイムスタンプである必要があります。
Identifier	String	はい	temperature	プロパティの識別子。弱い検証を使用する場合、次の手順を実行してデバイスプロパティの識別子を表示できます。IoT Platform コンソールにログインし、[製品の詳細] ページの [機能の定義] タブに移動します。QueryThingModel 操作を呼び出して、返された TSL データのプロパティ識別子を表示することもできます。検証を使用しない場合、値はデバイスによって送信されたカスタム識別子と同じである必要があります。
PageSize	Integer	はい	10	プロパティごとに返されるレコードの最大数。最大値：100。任意のプロパティに返されるレコード数は、制限を超えることはできません。
StartTime	Long	はい	1569249488000	クエリする時間範囲の開始。値は 13 桁のタイムスタンプである必要があります。
IotInstanceId	String	いいえ	iot_instc_pu***_c-v64********	インスタンスの ID。インスタンスの ID は、IoT Platform コンソールの概要ページで確認できます。重要インスタンスに ID がある場合は、このパラメーターに ID を指定する必要があります。指定しないと、呼び出しは失敗します。インスタンスに概要ページまたは ID が生成されていない場合は、このパラメーターを設定する必要はありません。詳細については、「概要」をご参照ください。
ProductKey	String	いいえ	a1BwAGV****	デバイスが属するプロダクトの ProductKey。重要このパラメーターに値を指定する場合は、DeviceName パラメーターを設定する必要があります。
DeviceName	String	いいえ	light	デバイスの DeviceName。重要このパラメーターに値を指定する場合は、ProductKey パラメーターを設定する必要があります。
NextPageToken	String	いいえ	Bo***x44Qx	クエリ結果の次のページを取得するために使用されるトークン。次のページが存在する場合、このパラメーターが返されます。この場合、次のリクエストにパラメーターの値を追加する必要があります。
IotId	String	いいえ	Q7uOhVRdZRRlDnTLv****00100	デバイスの ID。ID は、IoT Platform がデバイスに発行する一意の識別子です。重要 IotId パラメーターは、デバイスの一意の ID を指定します。IotId パラメーターの値は、ProductKey パラメーターと DeviceName.N パラメーターの値の組み合わせと同等です。 IotId パラメーターを指定する場合は、ProductKey パラメーターまたは DeviceName.N パラメーターを設定する必要はありません。IotId パラメーター、ProductKey パラメーター、および DeviceName.N パラメーターに値を指定した場合、IotId パラメーターの値が優先されます。

上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出す際に共通リクエストパラメーターを設定する必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

レスポンスパラメーター

パラメーター	タイプ	例	説明
Code	String	iot.device.InvalidIoTId	呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。
Data	Struct		呼び出しが成功した場合に返されるプロパティレコード。
List	PropertyInfo の配列		プロパティ。各要素はプロパティを示します。
PropertyInfo
Time	String	1516541885630	プロパティが変更された時間。
Value	String	{\"data\":32.43}	プロパティの値。
NextValid	Boolean	true	次のページが存在するかどうかを示します。 true: 次のページが存在します。 false: 次のページは存在しません。 true が NextValid パラメーターに対して返された場合は、NextPageToken パラメーターの値を次のリクエストに追加できます。このようにして、現在のクエリに含まれていないデータをクエリできます。
nextPageToken	String	Bo***x44Qx	クエリ結果の次のページを取得するために使用されるトークン。
ErrorMessage	String	システム例外が発生しました。	呼び出しが失敗した場合に返されるエラーメッセージ。
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	リクエスト ID。
Success	Boolean	true	呼び出しが成功したかどうかを示します。有効な値： true: 呼び出しは成功しました。 false: 呼び出しは失敗しました。

例

リクエストの例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceOriginalPropertyData
&Asc=0
&EndTime=1579249499000
&Identifier=temperature
&PageSize=10
&StartTime=1569249488000
&IotId=Q7uOhVRdZRRlDnTLv****00100
&<共通リクエストパラメータ>

正常なレスポンスの例

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
}

レスポンスパラメーター

エラーコードのリストについては、「サービスエラーコード」をご参照ください。

使用方法

QPS 制限

デバッグ

リクエストパラメーター

レスポンス パラメーター

例

レスポンスパラメーター

レスポンスパラメーター