CreateOTAModule - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Les modules OTA sont les unités mises à jour des appareils au sein d’un produit. Le module par défaut représente l’intégralité du micrologiciel de l’appareil. Appelez cette opération pour créer des modules OTA personnalisés.

Vous pouvez créer jusqu’à 10 modules OTA personnalisés par produit.
Une fois le module OTA créé, son nom ne peut plus être modifié. Appelez l’opération UpdateOTAModule pour modifier l’alias et la description du module.
Chaque compte Alibaba Cloud est limité à 10 requêtes par seconde (QPS).

Remarque
Les utilisateurs RAM d’un compte Alibaba Cloud partagent le quota de ce compte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d’appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l’exemple de code de l’opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateOTAModule	Opération à effectuer. Définissez la valeur sur CreateOTAModule.
ModuleName	String	Oui	barcodeScanner	Nom du module OTA. Ce nom doit être unique au sein d’un produit et ne peut pas être modifié après la création. Il peut contenir des lettres, des chiffres, des points (.), des traits d’union (-) et des traits de soulignement (_), et sa longueur doit être comprise entre 1 et 64 caractères. Remarque La casse des lettres n’est pas prise en compte. Par exemple, les noms de module scanner et Scanner ne peuvent pas coexister.
ProductKey	String	Oui	a1Le6d0****	ProductKey du produit auquel appartient le module OTA.
AliasName	String	Non	Barcode_scanner	Alias du module OTA. Sa longueur doit être comprise entre 1 et 64 caractères et il peut contenir des lettres, des chiffres, des points (.), des traits d’union (-) et des traits de soulignement (_).
IotInstanceId	String	Non	iot-cn-0pp1n8t****	ID de l’instance. Vous pouvez afficher 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. Sans cela, l’appel échouera. Si votre instance ne possède pas de Overview ou d’ID, vous n’avez pas besoin de définir ce paramètre. Pour plus d’informations, consultez Présentation.
Desc	String	Non	The firmware module of the barcode scanner.	Description du module OTA. Elle peut contenir jusqu’à 100 caractères.

En plus des paramètres de requête spécifiques à l’opération mentionnés ci-dessus, vous devez spécifier des paramètres de requête communs lors de l’appel de cette opération. Pour plus d’informations, consultez 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 de l’appel. Pour plus d’informations, consultez Codes d’erreur.
ErrorMessage	String	A system exception occurred.	Message d’erreur renvoyé en cas d’échec de l’appel.
RequestId	String	74C2BB8D-1D6F-41F5-AE68-6B2310883F63	ID de la requête.
Success	Boolean	true	Indique si l’appel a réussi. true : L’appel a réussi. false : L’appel a échoué.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

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

Format JSON

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

Codes d’erreur

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