Manifeste de mise à jour pour le service Device Update pour IoT Hub
Device Update pour IoT Hub utilise IoT Plug-and-Play pour envoyer des données à des appareils pendant le déploiement. L’un d’eux est le manifeste de mise à jour, une chaîne d’objet JSON sérialisée contenant les métadonnées de la mise à jour à installer. Il est également signé par chiffrement pour permettre à l’agent Device Update pour vérifier son authenticité. Consultez Sécurité de Device Update pour plus d’informations sur l’utilisation du manifeste de mise à jour en vue d’installer du contenu de manière sécurisée.
Manifeste d’importation et manifeste de mise à jour
Il est important de comprendre les différences entre le manifeste d’importation et les concepts de manifeste de mise à jour dans le service Device Update pour IoT Hub :
- Le manifeste d’importation est créé par quiconque produit la mise à jour correspondante. Il décrit le contenu de la mise à jour à importer dans le service Device Update pour IoT Hub.
- Le manifeste de mise à jour est généré automatiquement par le service Device Update pour IoT Hub, à l’aide de certaines des propriétés qui ont été définies dans le manifeste d’importation. Il est utilisé pour communiquer des informations pertinentes à l’agent Device Update pendant le processus de mise à jour.
Chaque type de manifeste a son propre schéma et sa propre version de schéma.
Schéma du manifeste de mise à jour
Important
Le schéma JSON du manifeste de mise à jour version 4 est hébergé sur SchemaStore.org.
Exemple de manifeste de mise à jour
{
"manifestVersion": "4",
"updateId": {
"provider": "Contoso",
"name": "Toaster",
"version": "1.0"
},
"compatibility": [
{
"manufacturer": "Contoso",
"model": "Toaster"
}
],
"instructions": {
"steps": [
{
"handler": "microsoft/swupdate:1",
"handlerProperties": {
"installedCriteria": "1.0"
},
"files": [
"fileId0"
]
}
]
},
"files": {
"fileId0": {
"filename": "contoso.toaster.1.0.swu",
"sizeInBytes": 718,
"hashes": {
"sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
}
}
},
"createdDateTime": "2021-09-28T18:32:01.8404544Z"
}
Manifeste de mise à jour minimal et manifeste de mise à jour complet
Lorsqu’un manifeste de mise à jour dépasse une certaine taille qui l’empêche d’être communiquée de manière efficace, Device Update pour IoT Hub l’envoie à un l’appareil au format détaché, également appelé manifeste de mise à jour minimal. Un manifeste minimal correspond techniquement aux métadonnées du manifeste de mise à jour et contient les informations nécessaires à l’agent Device Update pour télécharger le manifeste de mise à jour complet et vérifier son authenticité.
Exemple de manifeste de mise à jour minimal :
{
"manifestVersion": "4",
"updateId": {
"provider": "Contoso",
"name": "Toaster",
"version": "1.0"
},
"detachedManifestFileId": "fileId1",
"files": {
"fileId1": {
"filename": "contoso.toaster.1.0.updatemanifest.json",
"sizeInBytes": 2048,
"hashes": {
"sha256": "789s9PDfX4uA9wFUubyC30BWkLFbgmpkpmz1fEdqo2U="
}
}
}
}
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour