プロダクトの拡張 Thing Specification Language (TSL)パラメータに関する情報をクエリします。
QPS 制限
この API 操作は、アカウントごとに 1 秒あたり最大 20 回呼び出すことができます。
Alibaba Cloud アカウントの Resource Access Management (RAM)ユーザーは、アカウントのクォータを共有します。
デバッグ
リクエストパラメータ
パラメータ | タイプ | 必須 | 例 | 説明 |
Action | String | はい | QueryThingModelExtendConfig | 実行する操作。値を QueryThingModelExtendConfig に設定します。 |
ProductKey | String | はい | a1T27vz**** | プロダクトの ProductKey。 |
IotInstanceId | String | いいえ | iot-cn-0pp1n8t**** | インスタンス ID。インスタンス ID は、IoT Platform コンソールの 概要 タブで確認できます。 重要
インスタンスの詳細については、「概要」をご参照ください。 |
ResourceGroupId | String | いいえ | 123*** | リソースグループ ID。 重要 IoT Platform は、インスタンスごとのみリソースグループ管理をサポートしています。 ResourceGroupId パラメータは無効です。このパラメータを指定する必要はありません。 |
ModelVersion | String | いいえ | v1.0.0 | TSL モデルのバージョン番号。 ListThingModelVersion 操作を呼び出して、プロダクトの TSL モデルのバージョン番号を表示できます。 このパラメータを指定しないと、最後に公開されたバージョンが返されます。 |
FunctionBlockId | String | いいえ | BatteryModule | カスタム TSL モジュールの識別子。各識別子は、プロダクト内で一意です。 このパラメータを指定しないと、デフォルトモジュールがクエリされます。 |
上記の操作固有のリクエストパラメータに加えて、この操作を呼び出すときは、共通リクエストパラメータを指定する必要があります。共通リクエストパラメータの詳細については、「共通パラメータ」をご参照ください。
レスポンスパラメータ
パラメータ | タイプ | 例 | 説明 |
ErrorMessage | String | システム例外が発生しました。 | リクエストが失敗した場合に返されるエラーメッセージ。 |
Data | Struct | リクエストが成功した場合に返されるデータ。 | |
Configuration | String | {\"profile\":{\"productKey\":\"a114x******\"},\"properties\":[{\"originalDataType\":{\"specs\":{\"registerCount\":1,\"reverseRegister\":0,\"swap16\":0},\"type\":\"bool\"},\"identifier\":\"WakeUpData\",\"registerAddress\":\"0x04\",\"scaling\":1,\"writeFunctionCode\":0,\"operateType\":\"inputStatus\",\"pollingTime\":1000,\"trigger\":1}]} | 拡張 TSL パラメータに関する情報。拡張パラメータの定義の詳細については、CreateThingModel トピックの extendConfig の説明をご参照ください。 |
Code | String | iot.system.SystemException | リクエストが失敗した場合に返されるエラーコード。エラーコードの詳細については、「エラーコード」をご参照ください。 |
RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | リクエスト ID。 |
Success | Boolean | true | リクエストが成功したかどうかを示します。有効な値:
|
例
リクエストの例
https://iot.cn-shanghai.aliyuncs.com/?Action=QueryThingModelExtendConfig
&ProductKey=a1T27vz****
&<共通リクエストパラメータ>成功レスポンスの例
XML 形式
<QueryThingModelExtendConfigResponse>
<Data>
<Configuration>{"profile":{"productKey":"a114x******"},"properties":[{"originalDataType":{"specs":{"registerCount":1,"reverseRegister":0,"swap16":0},"type":"bool"},"identifier":"WakeUpData","registerAddress":"0x04","scaling":1,"writeFunctionCode":0,"operateType":"inputStatus","pollingTime":1000,"trigger":1}]}</Configuration>
</Data>
<RequestId>6DDF9D04-24C3-40D8-B490-2A528E59EA67</RequestId>
<Success>true</Success>
</QueryThingModelExtendConfigResponse>JSON 形式
{
"Data": {
"Configuration": "{\"profile\":{\"productKey\":\"a114x******\"},\"properties\":[{\"originalDataType\":{\"specs\":{\"registerCount\":1,\"reverseRegister\":0,\"swap16\":0},\"type\":\"bool\"},\"identifier\":\"WakeUpData\",\"registerAddress\":\"0x04\",\"scaling\":1,\"writeFunctionCode\":0,\"operateType\":\"inputStatus\",\"pollingTime\":1000,\"trigger\":1}]}"
},
"RequestId": "6DDF9D04-24C3-40D8-B490-2A528E59EA67",
"Success": true
}エラーコード
エラーコードのリストについては、「サービスエラーコード」をご参照ください。