ListThingModelVersion - IoT Platform - Centre de documentation Alibaba Cloud

Répertorie les versions du modèle de langage de spécification des objets (TSL) d'un produit donné.

Notes d'utilisation

Gérez les modèles TSL par version. Après avoir importé un modèle TSL via l'opération ImportThingModelTsl, copié un modèle TSL via l'opération CopyThingModel ou modifié un modèle TSL, publiez-le en appelant l'opération PublishThingModel pour le rendre utilisable. Chaque publication d'un modèle TSL pour un produit génère une nouvelle version.

Limites

Chaque compte Alibaba Cloud peut exécuter au maximum 10 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota de ce compte.

Débogage

Alibaba Cloud met à votre disposition OpenAPI Explorer pour simplifier l'utilisation des API. OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ListThingModelVersion	Opération à effectuer. Définissez la valeur sur ListThingModelVersion.
ProductKey	String	Oui	a1BwAGV****	Clé ProductKey du produit. Consultez la clé ProductKey sur la page Détails du produit de la console IoT Platform. Vous pouvez également obtenir la clé ProductKey en appelant l'opération QueryProductList.
IotInstanceId	String	Non	iot_instc_pu***_c-v64********	ID de l'instance. Consultez l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, configurez ce paramètre. Si vous ne définissez pas ce paramètre, l'appel échoue. Si votre instance ne possède pas de page Overview ou d'ID, vous n'avez pas besoin de définir ce paramètre. Pour plus d'informations, consultez Overview.

En plus des paramètres de requête spécifiques à l'opération ci-dessus, spécifiez les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations, consultez les paramètres de requête communs .

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez les Codes d'erreur.
Data	Struct		Données renvoyées en cas de réussite de l'appel.
ModelVersions	Array of ModelVersion		Liste des versions du modèle TSL. Les versions sont affichées par ordre décroissant selon l'heure de publication. La première version correspond à la version actuelle.
Description	String	Add a light property	Description de la version du modèle TSL.
GmtCreate	Long	1579235657535	Horodatage de publication de la version du modèle TSL. L'heure est affichée au format UTC. Unité : millisecondes.
ModelVersion	String	V1.0.0	Numéro de version du modèle TSL.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=ListThingModelVersion
&ProductKey=a1rYuVF****
&<Common request parameters>

Exemple de réponse réussie

Format 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>

Format 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
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API .