ListThingTemplates - IoT Platform - Centre de documentation Alibaba Cloud

Notes d'utilisation

IoT Platform propose des catégories de produits assorties de modèles TSL prédéfinis, tels que les lampadaires, les cartes de localisation de véhicules et les détecteurs d'immersion dans l'eau.

Lorsque vous appelez l'opération CreateProduct pour créer un produit, définissez le paramètre CategoryKey pour spécifier une catégorie. Le produit créé référence alors le modèle TSL standardisé de la catégorie indiquée.

Limites

Chaque compte Alibaba Cloud peut exécuter au maximum 5 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. Cet outil calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter

Type

Required

Example

Description

Action

String

Yes

ListThingTemplates

L'opération à effectuer. Définissez la valeur sur ListThingTemplates.

IotInstanceId

String

No

iot_instc_pu****_c*-v64********

L'ID de l'instance. Vous pouvez consulter cet identifiant sur la page Overview de la console IoT Platform.

Important

Si votre instance possède un ID, vous devez configurer ce paramètre. À défaut, l'appel échoue.
Si votre instance ne dispose pas de page Overview ou d'ID, il n'est pas nécessaire de définir ce paramètre.

Pour en savoir plus, consultez la rubrique Overview.

Outre les paramètres de requête spécifiques à cette opération, vous devez indiquer les paramètres de requête communs lors de l'appel. Pour plus de détails, reportez-vous à la section Paramètres de requête communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Le code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la page Codes d'erreur.
Data	Array of CategoryInfo		La liste des catégories standard renvoyée si l'appel aboutit.
CategoryKey	String	lighting	L'identifiant de la catégorie.
CategoryName	String	Street Lamp	Le nom de la catégorie.
ErrorMessage	String	A system exception occurred.	Le message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	L'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=ListThingTemplates
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

<ListThingTemplatesResponse>
  <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
  <Success>true</Success>
  <Data>
        <CategoryName>Smart Rear-view Mirror</CategoryName>
        <CategoryKey>SmartRearviewMirror</CategoryKey>
  </Data>
  <Data>
        <CategoryName>Smart In-vehicle Infotainment</CategoryName>
        <CategoryKey>SmartTox</CategoryKey>
  </Data>
</ListThingTemplatesResponse>

Format JSON

{
  "RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
  "Success":true,
  "Data": [
    {
      "CategoryName": "Smart Rearview Mirror",
      "CategoryKey": "SmartRearviewMirror"
    },
    {
      "CategoryName": "Smart In-vehicle Infotainment",
      "CategoryKey": "SmartTox"
    }
  ]
}

Codes d'erreur

Pour consulter la liste des codes d'erreur, rendez-vous sur le Centre d'erreurs API.