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

指定されたプロダクトのモノの仕様記述言語 (TSL) モデルバージョンをクエリします。

使用方法

TSL モデルはバージョンごとに管理できます。ImportThingModelTsl 操作を呼び出して TSL モデルをインポートした後、CopyThingModel 操作を呼び出して TSL モデルをコピーした後、または TSL モデルを編集した後、PublishThingModel 操作を呼び出して TSL モデルを公開する必要があります。その後、TSL モデルを使用できるようになります。プロダクトの TSL モデルが公開されるたびに、新しいバージョンが生成されます。

制限

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

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

デバッグ

Alibaba Cloud は、API の使用を簡素化するために OpenAPI Explorer を提供しています。OpenAPI Explorer は署名の値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK 用の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	はい	ListThingModelVersion	実行する操作。値を ListThingModelVersion に設定します。
ProductKey	String	はい	a1BwAGV****	プロダクトの ProductKey。 ProductKey は、IoT Platform コンソールの [プロダクトの詳細] ページで確認できます。また、QueryProductList 操作を呼び出すことによって、ProductKey を取得することもできます。
IotInstanceId	String	いいえ	iot_instc_pu***_c-v64********	インスタンスの ID。インスタンス ID は、IoT Platform コンソールの概要ページで確認できます。重要インスタンスに ID がある場合は、このパラメーターを設定する必要があります。このパラメーターを設定しないと、呼び出しは失敗します。インスタンスに概要ページまたは ID がない場合は、このパラメーターを設定する必要はありません。詳細については、「概要」をご参照ください。

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

レスポンスパラメーター

パラメーター	タイプ	例	説明
Code	String	iot.system.SystemException	呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。
Data	Struct		呼び出しが成功した場合に返されるデータ。
ModelVersions	ModelVersion の配列		TSL モデルバージョンのリスト。バージョンは、リリース時刻に基づいて降順で表示されます。最初のバージョンが現在のバージョンです。
Description	String	ライトプロパティを追加	TSL モデルバージョンの説明。
GmtCreate	Long	1579235657535	TSL モデルバージョンが公開されたときのタイムスタンプ。時刻は UTC で表示されます。単位：ミリ秒。
ModelVersion	String	V1.0.0	TSL モデルのバージョン番号。
ErrorMessage	String	システム例外が発生しました。	呼び出しが失敗した場合に返されるエラーメッセージ。
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	リクエストの ID。
Success	Boolean	true	呼び出しが成功したかどうかを示します。 true: 呼び出しは成功しました。 false: 呼び出しは失敗しました。

例

リクエストの例

https://iot.cn-shanghai.aliyuncs.com/?Action=ListThingModelVersion
&ProductKey=a1rYuVF****
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

<ListThingModelVersionResponse>
  <Data>
        <ModelVersions>
              <ModelVersion>V3.0.0</ModelVersion>
              <GmtCreate>1579235682421</GmtCreate>
              <Description>new properties</Description>
        </ModelVersions>
        <ModelVersions>
              <ModelVersion>V2.0.0</ModelVersion>
              <GmtCreate>1579235657535</GmtCreate>
              <Description>new properties</Description>
        </ModelVersions>
        <ModelVersions>
              <ModelVersion>V1.0.0</ModelVersion>
              <GmtCreate>1579235637994</GmtCreate>
              <Description>Lighting</Description>
        </ModelVersions>
  </Data>
  <RequestId>9BA34AE5-2D94-4BDE-BD78-E7D3FC7985BC</RequestId>
  <Success>true</Success>
</ListThingModelVersionResponse>

JSON 形式

{
  "Data": {
    "ModelVersions": [
      {
        "ModelVersion": "V3.0.0",
        "GmtCreate": 1579235682421,
        "Description": "new properties"
      },
      {
        "ModelVersion": "V2.0.0",
        "GmtCreate": 1579235657535,
        "Description": "new properties"
      },
      {
        "ModelVersion": "V1.0.0",
        "GmtCreate": 1579235637994,
        "Description": "Lighting"
      }
    ]
  },
  "RequestId": "9BA34AE5-2D94-4BDE-BD78-E7D3FC7985BC",
  "Success": true
}

エラーコード

エラーコードの一覧については、API エラーセンターをご覧ください。