Todos los productos
Search
Centro de documentos

IoT Platform:UpdateOTAModule

Última actualización: Sep 03, 2026

Modifica el alias y la descripción de un módulo OTA.

Límites

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

Nota

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

Depuración

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íUpdateOTAModule

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

ModuleNameStringSíbarcodeScanner

El nombre del módulo OTA.

ProductKeyStringSía1Le6d0****

La clave ProductKey del producto al que pertenece el módulo OTA.

AliasNameStringNoBarcode_scanner_2

El nuevo alias del módulo OTA. El alias debe tener entre 1 y 64 caracteres, y puede contener letras, dígitos, puntos (.), guiones (-) y guiones bajos (_).

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 Descripción general.

DescStringNoThe firmware module of the barcode scanner.

La nueva descripción del módulo OTA. La descripción puede tener hasta 100 caracteres.

Además de los parámetros específicos de la operación anteriores, especifique los parámetros de solicitud comunes al llamar a esta operación. Para obtener más información, consulte Parámetros de solicitud comunes.

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 Códigos de error.

ErrorMessageStringA system exception occurred.

El mensaje de error devuelto si la llamada falla.

RequestIdString74C2BB8D-1D6F-41F5-AE68-6B2310883F63

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

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateOTAModule
&ModuleName=barcodeScanner
&ProductKey=a1Le6d0****
&AliasName=Barcode_scanner_2
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<UpdateOTAModuleResponse>
     <RequestId>29EC7245-0FA4-4BB6-B4F5-5F04818FDFB1</RequestId>
     <Success>true</Success>
</UpdateOTAModuleResponse>

Formato JSON

{
  "RequestId": "9F41D14E-CB5F-4CCE-939C-057F39E688F5",
  "Success": true
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.