すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:QueryThingModelExtendConfig

最終更新日:Apr 17, 2025

プロダクトの拡張 Thing Specification Language (TSL)パラメータに関する情報をクエリします。

QPS 制限

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

説明

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

デバッグ

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

リクエストパラメータ

パラメータ

タイプ

必須

例

説明

Action

String

はい

QueryThingModelExtendConfig

実行する操作。値を QueryThingModelExtendConfig に設定します。

ProductKey

String

はい

a1T27vz****

プロダクトの ProductKey。

IotInstanceId

String

いいえ

iot-cn-0pp1n8t****

インスタンス ID。インスタンス ID は、IoT Platform コンソールの 概要 タブで確認できます。

重要
  • インスタンスに ID がある場合は、このパラメータを指定する必要があります。このパラメータを指定しないと、リクエストは失敗します。

  • IoT Platform コンソールに 概要 タブまたはインスタンス ID が表示されない場合は、このパラメータを指定する必要はありません。

インスタンスの詳細については、「概要」をご参照ください。

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

リクエストが成功したかどうかを示します。有効な値:

  • true

  • false

例

リクエストの例

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
}

エラーコード

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