Todos los productos
Search
Centro de documentos

IoT Platform:UpdateThingScript

Última actualización: Sep 03, 2026

Modifica un script de análisis de datos para un producto específico.

Notas de uso

  • El script de análisis de datos convierte los datos con formato personalizado a JSON después de que el dispositivo los envía. Escriba el script en JavaScript, Python 2.7 o PHP 7.2. Para obtener más información, consulte Submit scripts for data parsing.

  • Cada cuenta de Alibaba Cloud admite un máximo de 10 consultas por segundo (QPS).

    Nota

    Los usuarios de RAM de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.

Depuración

Alibaba Cloud proporciona OpenAPI Explorer para simplificar el uso de la API. OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíUpdateThingScript

La operación que desea ejecutar. Establezca el valor en UpdateThingScript.

ProductKeyStringSía1Q5XoY****

El ProductKey del producto.

Consulte el ProductKey en la página Product Details de la consola de IoT Platform. También puede obtener el ProductKey mediante la operación QueryProductList.

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

El contenido del script. Debe especificar este parámetro.

Para obtener más información sobre ejemplos de scripts, consulte What is data parsing.

ScriptTypeStringSíJavaScript

El tipo de script. Valores válidos:

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

El ID de la instancia. Consulte el ID de la instancia en la página Overview de la consola de IoT Platform.

Importante
  • Si su instancia tiene un ID, configure este parámetro. De lo contrario, la llamada fallará.
  • Si su instancia no tiene página de Overview o ID, omita este parámetro.

Para obtener más información, consulte Overview.

Además de los parámetros de solicitud específicos de la operación mencionados anteriormente, debe especificar los parámetros de solicitud comunes al ejecutar esta operación. Para obtener más información, consulte Common request parameters.

Parámetros de respuesta

ParámetroTipoEjemploDescripción
CodeStringiot.system.SystemException

El código de error devuelto si la llamada falla. Para obtener más información, consulte Error codes.

ErrorMessageStringA system exception occurred.

El mensaje de error devuelto si la llamada falla.

RequestIdStringBB71E443-4447-4024-A000-EDE09922891E

El ID de la solicitud.

SuccessBooleantrue

Indica si la llamada fue exitosa.

  • true: La llamada fue exitosa.
  • false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

Formato XML

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

Formato JSON

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

Códigos de error

Para obtener una lista de códigos de error, visite el API Error Center.