Tous les produits
Search
Centre de documentation

IoT Platform:UpdateThingScript

Dernière mise à jour :Aug 09, 2026

Modifie un script d'analyse des données pour un produit spécifié.

Notes d'utilisation

  • Un script d'analyse des données convertit les données au format personnalisé en données JSON après leur soumission par un appareil. Vous pouvez rédiger un script en JavaScript, Python 2.7 et PHP 7.2. Pour plus d'informations, consultez la rubrique Soumettre des scripts pour l'analyse des données.

  • Chaque compte Alibaba Cloud accepte un maximum de 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 afin de simplifier l'utilisation des API. OpenAPI Explorer calcule automatiquement la valeur de la signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de la requête

ParameterTypeRequiredExampleDescription
ActionStringYesUpdateThingScript

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

ProductKeyStringYesa1Q5XoY****

Clé ProductKey du produit.

Vous pouvez consulter la clé ProductKey sur la page des détails du produit dans la console IoT Platform. Vous pouvez également obtenir la clé ProductKey en appelant l'opération QueryProductList.

ScriptContentStringYes"function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"

Contenu du script. Ce paramètre est obligatoire.

Pour plus d'informations sur les exemples de scripts, consultez la rubrique Présentation de l'analyse des données.

ScriptTypeStringYesJavaScript

Type de script. Valeurs possibles :

  • JavaScript
  • Python_27 : Python 2.7
  • PHP_72 : PHP 7.2
IotInstanceIdStringNoiot-cn-0pp1n8t****

ID de l'instance. Vous pouvez consulter l'ID de l'instance 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 échouera.
  • 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 plus d'informations, consultez la rubrique Overview.

Outre les paramètres de requête spécifiques à cette opération, vous devez spécifier les paramètres de requête communs lors de l'appel. Pour plus d'informations, consultez la rubrique Paramètres de requête communs.

Paramètres de réponse

ParameterTypeExampleDescription
CodeStringiot.system.SystemException

Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la rubrique Codes d'erreur.

ErrorMessageStringA system exception occurred.

Message d'erreur renvoyé en cas d'échec de l'appel.

RequestIdStringBB71E443-4447-4024-A000-EDE09922891E

ID de la requête.

SuccessBooleantrue

Indique si l'appel a abouti.

  • true : L'appel a abouti.
  • false : L'appel a échoué.

Exemples

Exemple de requête

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

Exemple de réponse en cas de succès

Format XML

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

Format JSON

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

Codes d'erreur

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