すべてのプロダクト
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
}

エラーコード

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