調用該接口獲取指定產品的物模型版本列表。

使用說明

物模型已實現版本化管理，您導入物模型（ImportThingModelTsl）、復制其他產品物模型（CopyThingModel）或編輯更新物模型后，需調用PublishThingModel將物模型發布后才能被使用。一個產品的物模型每發布一次，生成一個版本。

QPS限制

單個阿里云賬號調用該接口的每秒請求數（QPS）最大限制為10。

說明 RAM用戶共享阿里云賬號配額。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 ListThingModelVersion

系統規定參數。取值：ListThingModelVersion。
ProductKey String 是 a1BwAGV****

產品的ProductKey。

可以在物聯網平臺控制臺產品頁查看，或調用QueryProductList查看ProductKey的取值。

IotInstanceId String 否 iot_instc_pu****_c*-v64********

實例ID。您可在物聯網平臺控制臺的實例概覽頁面，查看當前實例的ID。

注意
  • 若有ID值，必須傳入該ID值，否則調用會失敗。
  • 若無ID值，則無需傳入。

實例的更多信息，請參見實例概述。

調用API時，除了本文介紹的該API的特有請求參數，還需傳入公共請求參數。公共請求參數說明，請參見公共參數文檔。

返回數據

名稱 類型 示例值 描述
Code String iot.system.SystemException

調用失敗時，返回的錯誤碼。更多信息，請參見錯誤碼。

Data Struct

調用成功時，返回的數據。
ModelVersions Array of ModelVersion

物模型版本列表。按照物模型發布時間倒序排列。第一個為當前使用的版本。
Description String 增加一個light屬性

物模型版本的描述。
GmtCreate Long 1579235657535

該版本物模型發布時的時間戳，格式為GMT毫秒值。
ModelVersion String V1.0.0

物模型版本號。
ErrorMessage String 系統異常

調用失敗時，返回的出錯信息。
RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

阿里云為該請求生成的唯一標識符。
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
}