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

指定されたデバイスから送信された元のプロパティのスナップショットを照会します。これらのスナップショットには、指定された Thing Specification Language（TSL）モデルによって検証されたプロパティと検証されていないプロパティが含まれます。

制限

Alibaba Cloud アカウントごとに、最大 50 クエリ/秒（QPS）を実行できます。

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

デバッグ

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	Yes	QueryDeviceOriginalPropertyStatus	実行する操作。値を QueryDeviceOriginalPropertyStatus に設定します。
Asc	Integer	Yes	0	プロパティデータが照会される時間順。有効な値： 0: 逆時間順。 1: 時間順。
PageSize	Integer	Yes	10	各ページに返すエントリの数。有効な値：1～50。
IotInstanceId	String	No	iot_instc_pu***_c-v64********	インスタンスの ID。インスタンス ID は、IoT Platform コンソールの概要ページで確認できます。重要インスタンスに ID がある場合は、このパラメーターを設定する必要があります。このパラメーターを設定しないと、呼び出しは失敗します。インスタンスに概要ページまたは ID がない場合は、このパラメーターを設定する必要はありません。詳細については、「概要」をご参照ください。
ProductKey	String	No	a1BwAGV****	デバイスが属するプロダクトの ProductKey。説明このパラメーターを指定する場合は、DeviceName パラメーターも指定する必要があります。
DeviceName	String	No	light	デバイスの名前。説明このパラメーターを指定する場合は、ProductKey パラメーターも指定する必要があります。
NextPageToken	String	No	Bo***x44Qx	次のページの識別子。次のページが存在する場合、このパラメーターが返されます。この場合、次のリクエストにパラメーターの値を追加する必要があります。
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	デバイスの ID。IoT Platform がデバイスに生成した一意の識別子です。説明このパラメーターを指定する場合は、ProductKey または DeviceName パラメーターを指定する必要はありません。IotId パラメーターはデバイスの一意の識別子を指定し、ProductKey パラメーターと DeviceName パラメーターの組み合わせに対応します。IotId パラメーターと ProductKey パラメーターと DeviceName パラメーターの組み合わせを同時に指定した場合、IotId パラメーターが優先されます。

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

レスポンスパラメーター

パラメーター	タイプ	例	説明
Code	String	iot.common.InvalidPageParams	呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。
Data	Struct		呼び出しが成功した場合に返されるデータ。詳細については、List パラメーターのパラメーターをご参照ください。
List	PropertyStatusDataInfo の配列		プロパティ情報の配列。各プロパティに関する情報は、PropertyStatusInfo パラメーターによって示されます。
PropertyStatusDataInfo
Identifier	String	Temperture	プロパティの識別子。
Time	Long	1517553572362	プロパティが変更された時刻（ミリ秒）。
Value	String	26	プロパティの値。
NextPageToken	String	Bo***x44Qx	次のページの識別子。
NextValid	Boolean	true	次のページが存在するかどうかを示します。 true: 次のページが存在します。 false: 次のページは存在しません。値 trueNextPageToken パラメーターの値を次のクエリに追加できます。これにより、現在のクエリでは返されないデータをクエリできます。
ErrorMessage	String	A system exception has occurred.	呼び出しが失敗した場合に返されるエラーメッセージ。
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	リクエストの ID。
Success	Boolean	true	呼び出しが成功したかどうかを示します。 true: 呼び出しは成功しました。 false: 呼び出しは失敗しました。

例

リクエストの例

http(s)://iot.cn-shanghai.aliyuncs.com/? Action=QueryDeviceOriginalPropertyStatus
&Asc=0
&PageSize=10
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

<QueryDeviceOriginalPropertyStatusResponse>
  <Data>
        <NextValid>false</NextValid>
        <nextPageToken>Bo***x44Qx</nextPageToken>
        <List>
              <PropertyStatusInfo>
                    <Value>48</Value>
                    <Time>1579249151178</Time>
                    <Identifier>Humidity</Identifier>
              </PropertyStatusInfo>
              <PropertyStatusInfo>
                    <Value>32.46</Value>
                    <Time>1579249151178</Time>
                    <Identifier>Temperature</Identifier>
              </PropertyStatusInfo>
        </List>
  </Data>
  <RequestId>84BAD25B-9879-4BA1-9213-F576C6558D77</RequestId>
  <Success>true</Success>
</QueryDeviceOriginalPropertyStatusResponse>

JSON 形式

{
    "Data": {
        "NextValid": false, 
        "nextPageToken": "Bo***x44Qx", 
        "List": {
            "PropertyStatusInfo": [
                {
                    "Value": "48",
                    "Time": "1579249151178",
                    "Identifier": "Humidity"
                },
                {
                    "Value": "32.46",
                    "Time": "1579249151178",
                    "Identifier": "Temperature"
                }
            ]
        }
    },
    "RequestId": "84BAD25B-9879-4BA1-9213-F576C6558D77",
    "Success": true
}

エラーコード

API エラーセンターにアクセスして、エラーコードのリストをご確認ください。