Tous les produits
Search
Centre de documentation

IoT Platform:CreateThingScript

Dernière mise à jour :Aug 09, 2026

Soumet un script d'analyse des données pour un produit donné.

Notes d'utilisation

Les scripts d'analyse des données convertissent les données de périphérique au format personnalisé en JSON. Langues prises en charge : JavaScript, Python 2.7 et PHP 7.2. Pour plus d'informations, consultez la rubrique Soumettre des scripts d'analyse des données.

Important

L'opération CreateThingScript n'est pas prise en charge si le format des données est Alink JSON. Alink JSON est un format de données standard défini par l'IoT Connectivity Alliance (ICA).

Limites de QPS

Maximum : 10 requêtes par seconde (QPS) par compte Alibaba Cloud.

Remarque

Les utilisateurs RAM (Resource Access Management) d'un compte Alibaba Cloud partagent le quota du compte.

Débogage

OpenAPI Explorer calcule la valeur de signature et génère des exemples de code pour différents SDK. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer.

Paramètres de requête

Paramètre Type Obligatoire Exemple Description
Action String Oui CreateThingScript

Opération à exécuter. Définissez la valeur sur CreateThingScript.

ProductKey String Oui a1Q5XoY****

ProductKey du produit.

Consultez le ProductKey sur la page des détails du produit dans la console IoT Platform, ou appelez l'opération QueryProductList.

ScriptContent String Oui "function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"

Contenu du script.

Des exemples de scripts sont disponibles dans la rubrique Présentation de l'analyse des données.

ScriptType String Oui JavaScript

Langue du script. Valeurs valides :

  • JavaScript
  • Python_27 : Python 2.7
  • PHP_72 : PHP 7.2
IotInstanceId String Non iot-cn-0pp1n8t****

ID de l'instance. Consultez l'ID sur la page Aperçu de la console IoT Platform.

Important
  • Obligatoire si votre instance possède un ID. Dans le cas contraire, l'appel échoue.
  • Non requis si la page Aperçu n'est pas affichée dans la console ou si aucun ID n'existe pour votre instance.

Aperçu.

Cette opération nécessite également 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. Consultez la liste des codes d'erreur.

ErrorMessage String Une exception système s'est produite.

Message d'erreur renvoyé en cas d'échec.

RequestId String BB71E443-4447-4024-A000-EDE09922891E

ID de la requête.

Success Boolean true

Indique si la requête a abouti.

  • true : La requête a abouti.
  • false : La requête a échoué.

Exemples

Exemples de requêtes

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=CreateThingScript
&ProductKey=a1Q5XoY****
&ScriptContent="function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"
&ScriptType=JavaScript
&<Common request parameters>

Exemples de réponses réussies

Format XML

<CreateThingScriptResponse>
    <RequestId>BB71E443-4447-4024-A000-EDE09922891E</RequestId>
    <Success>true</Success>
</CreateThingScriptResponse>

Format JSON

{
      "RequestId":"BB71E443-4447-4024-A000-EDE09922891E",
      "Success":true
  }

Codes d'erreur

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