IoT Platform permet aux appareils de charger des fichiers vers vos compartiments Object Storage Service (OSS) ou vers le stockage de fichiers d'IoT Platform via MQTT , ce qui réduit la surcharge matérielle et les coûts de développement. Configurez le SDK C Link pour activer le chargement de fichiers pour vos appareils.
Prérequis
Vous avez obtenu les informations d'identification de l'appareil.
-
Vous avez obtenu le SDK C Link.
Pour personnaliser le SDK, sur la page SDK Customization, dans la zone Advanced Features, sélectionnez File Upload.
Contexte
IoT Platform propose une fonctionnalité de gestion des fichiers pour les fichiers chargés.
-
Une fois qu'un appareil a chargé un fichier, gérez-le à l'aide des API cloud suivantes :
Fonctionnement
Les appareils chargent des fichiers vers IoT Platform via MQTT :
Référence de l'API de chargement MQTT : aiot_mqtt_upload_api.h.
Le chargement de fichiers nécessite une connexion MQTT.
Diagramme de séquence pour ./demos/mqtt_upload_basic_demo.c :

Limites
Les appareils ne peuvent charger des fichiers via le protocole MQTT que dans les régions Chine (Shanghai), Chine (Pékin) et Chine (Shenzhen).
-
Exigences relatives aux noms de fichiers :
Les caractères autorisés sont les chiffres, les lettres, les traits de soulignement (_) et les points (.).
Le premier caractère doit être une lettre ou un chiffre.
La longueur maximale est de 100 octets.
Le chargement de plusieurs fichiers est pris en charge.
Stockage total maximal par instance : 1 Go.
Nombre maximal de fichiers par appareil : 1 000.
Taille maximale d'un fichier unique : 16 Mo.
-
IoT Platform applique une politique de gestion des conflits basée sur le nom de fichier pour chaque demande de chargement :
Si aucun fichier portant le même nom n'existe, une nouvelle tâche de chargement est créée.
-
Si un fichier portant le même nom existe, IoT Platform applique la politique de gestion des doublons configurée. Exemple de code : Étape 4 : Demande de chargement d'un fichier.
Politique (conflictStrategy)
Description
Mode d'écrasement (overwrite)
Par défaut. Supprime le fichier existant et conserve uniquement le nouveau chargement.
Mode d'ajout (append)
IoT Platform renvoie des informations sur le fichier existant. L'appareil peut :
-
Si le fichier a été partiellement chargé, reprendre le chargement.
RemarqueLes chargements incomplets sont conservés pendant 24 heures uniquement.
-
Si le fichier a été entièrement chargé, utilisez le mode d'écrasement ou renommez le fichier avant de le recharger.
Mode de rejet (reject)
IoT Platform renvoie un code d'erreur indiquant que le fichier existe déjà et rejette la demande de chargement.
-