Importer une mise à jour dans Device Update pour IoT Hub
Découvrez comment obtenir une nouvelle mise à jour et l’importer dans Device Update pour IoT Hub. Si vous ne l’avez pas encore fait, veillez à passer en revue les concepts d’importation clés et le guide préparation d’une mise à jour à importer.
Prérequis
- Accès à un hub IoT avec Device Update pour IoT Hub activé.
- Un appareil (ou un simulateur) IoT provisionné pour Device Update dans IoT Hub.
- PowerShell 5 ou ultérieur (y compris les installations Linux, macOS et Windows)
- Navigateurs pris en charge :
- Microsoft Edge
- Google Chrome
Importer une mise à jour
Notes
Les instructions suivantes montrent comment importer une mise à jour par le biais de l’interface utilisateur du portail Azure. Vous pouvez également utiliser les API Device Update pour IoT Hub pour importer une mise à jour.
Connectez-vous au portail Azure et accédez à votre hub IoT avec Device Update.
Sur le côté gauche de la page, sélectionnez
Updates
sousDevice Management
.Sélectionnez l’onglet
Updates
dans la liste des onglets en haut de l’écran.Sélectionnez
+ Import a new update
sous l’en-têteAvailable Updates
.Sélectionnez
+ Select from storage container
. L’interface utilisateur des comptes de stockage s’affiche. Sélectionnez un compte existant ou créez un compte avec+ Storage account
. Ce compte est utilisé pour un conteneur afin de préparer vos mises à jour pour l’importation.Une fois que vous avez sélectionné un compte de stockage, l’interface utilisateur Conteneurs s’affiche. Sélectionnez un conteneur existant ou créez-en un avec
+ Container
. Ce conteneur est utilisé afin de préparer vos fichiers de mise à jour pour l’importation. Recommandation : Utilisez un nouveau conteneur chaque fois que vous importez une mise à jour pour éviter d’importer accidentellement des fichiers à partir de mises à jour précédentes. Si vous n’utilisez pas un nouveau conteneur, veillez à supprimer tous les fichiers du conteneur existant avant d’effectuer cette étape.Dans votre conteneur, sélectionnez
Upload
. L’interface utilisateur Charger est présentée.Sélectionnez l’icône de dossier à droite de la section
Files
sous l’en-têteUpload blob
. Utilisez le sélecteur de fichiers pour accéder à l’emplacement de vos fichiers de mise à jour et au manifeste d’importation, sélectionnez tous les fichiers, puis sélectionnezOpen
. Pour sélectionner plusieurs fichiers, vous pouvez maintenir la touche Maj enfoncée tout en cliquant sur chaque fichier.Une fois que vous avez sélectionné tous vos fichiers de mise à jour, sélectionnez
Upload
.Sélectionnez les fichiers chargés pour indiquer de les importer. Cliquez ensuite sur le bouton
Select
pour revenir à la pageImport update
.Dans la page Importer la mise à jour, passez en revue les fichiers à importer. Sélectionnez ensuite
Import update
pour démarrer le processus d’importation. Pour résoudre les erreurs, consultez la page Résolution des problèmes de mise à jour de proxy.Le processus d’importation commence et l’écran passe à la section
Import History
. SélectionnezRefresh
pour voir la progression jusqu’à la fin du processus d’importation (selon la taille de la mise à jour, cette opération peut prendre quelques minutes ou durer plus longtemps).Quand la colonne
Status
indique que l’importation a réussi, sélectionnez l’en-têteAvailable Updates
. Vous devez maintenant voir votre mise à jour importée dans la liste.
Si vous importez plutôt via des APIs
Outre l’importation par le biais du portail Azure, vous pouvez également importer une mise à jour par programmation :
- Avec
Azure SDK
pour .NET, Java, JavaScript ou Python - Avec l’API REST Importer la mise à jour
- Avec des exemples de modules PowerShell
Remarque
Pour l’autorisation d’API requise, consultez les rôles d’utilisateur et l’accès à Device Update.
Vous devez charger les fichiers de mise à jour et le manifeste d’importation dans un conteneur Azure Storage Blob pour la préproduction. Pour importer les fichiers de préproduction, fournissez l’URL de l’objet blob, ou la signature d’accès partagé (SAS) pour les objets blob privés, à l’API Device Update. Si vous utilisez une signature d’accès partagé, veillez à fournir une fenêtre d’expiration de trois heures ou plus.
Conseil
Pour charger des fichiers de mise à jour volumineux dans un conteneur Azure Storage Blob, vous pouvez utiliser l’un des éléments suivants pour améliorer les performances :