CreateThingScript - IoT Platform - Centro de documentación de Alibaba Cloud

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

Notas de uso

Los scripts de análisis de datos convierten los datos del dispositivo en formato personalizado a JSON. Lenguajes compatibles: JavaScript, Python 2.7 y PHP 7.2. Enviar scripts para el análisis de datos.

Importante

Si el formato de datos es

Alink JSON

, CreateThingScript no es compatible. Alink JSON es un formato de datos estándar definido por IoT Connectivity Alliance (ICA).

Límites de QPS

Máximo: 10 consultas por segundo (QPS) por cuenta de Alibaba Cloud.

Nota

Los usuarios de Resource Access Management (RAM) de una cuenta de Alibaba Cloud comparten la cuota de la cuenta.

Depuración

OpenAPI Explorer calcula el valor de la firma y genera código de ejemplo para diferentes SDK. Se recomienda llamar a esta operación desde OpenAPI Explorer.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateThingScript	La operación a ejecutar. Establezca el valor en CreateThingScript.
ProductKey	String	Sí	a1Q5XoY****	El ProductKey del producto. Consulte el ProductKey en la página Product Details de la consola de IoT Platform o llame a la operación QueryProductList.
ScriptContent	String	Sí	"function protocolToRawData(jsonObj) {return rawdata; }function rawDataToProtocol(rawData) {return jsonObj; }"	El contenido del script. Puede consultar ejemplos de scripts en Qué es el análisis de datos.
ScriptType	String	Sí	JavaScript	El lenguaje del script. Valores válidos: JavaScript Python_27: Python 2.7 PHP_72: PHP 7.2
IotInstanceId	String	No	iot-cn-0pp1n8t****	El ID de la instancia. Consulte el ID en la página Overview de la consola de IoT Platform. Importante Obligatorio si su instancia tiene un ID. De lo contrario, la llamada fallará. No es obligatorio si la página Overview no se muestra en la consola o si su instancia no tiene ID. Descripción general.

Esta operación también requiere los parámetros de solicitud comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Code	String	iot.system.SystemException	El código de error devuelto en caso de fallo. Códigos de error.
ErrorMessage	String	A system exception occurred.	El mensaje de error devuelto en caso de fallo.
RequestId	String	BB71E443-4447-4024-A000-EDE09922891E	El ID de la solicitud.
Success	Boolean	true	Indica si la solicitud se realizó correctamente. true: La solicitud fue exitosa. false: La solicitud falló.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

Formato XML

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

Formato JSON

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

Códigos de error

Para consultar la lista de códigos de error, visite el Centro de errores de API.