Partager via

Manifeste de mise à jour d'Azure Device Update pour IoT Hub

  • Article

Cet article décrit les données du manifeste de mise à jour qu’Azure Device Update pour IoT Hub envoie aux appareils pendant le déploiement de mises à jour. Le manifeste de mise à jour est un objet de chaîne JSON sérialisé contenant des métadonnées sur la mise à jour à installer.

Device Update utilise IoT Plug and Play pour envoyer le manifeste de mise à jour et le signe de manière cryptographique afin que l’agent Device Update puisse en vérifier l’authenticité. Pour plus d’informations sur la manière dont le manifeste de mise à jour est utilisé pour installer du contenu en toute sécurité, consultez Sécurité de Device Update.

Manifeste d’importation et manifeste de mise à jour

Le manifeste de mise à jour est différent du manifeste d’importation Device Update.

  • Le manifeste d’importation est un fichier JSON qui décrit la mise à jour à importer dans Device Update. Celui qui crée la mise à jour pour Device Update crée le fichier de manifeste d’importation correspondant.
  • Le manifeste de mise à jour est un objet de chaîne JSON qui communique des informations à l’agent Device Update pendant une mise à jour. Le service Device Update génère automatiquement le manifeste de mise à jour en incluant certaines des mêmes propriétés définies dans le manifeste d’importation.

Chaque type de manifeste a son propre schéma et sa propre version de schéma. Pour plus d’informations sur le schéma du manifeste d’importation, voir Schéma du manifeste d’importation Device Update.

Schéma du manifeste de mise à jour

Le manifeste de mise à jour du schéma JSON 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:2",
        "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

Si un manifeste de mise à jour est trop volumineux pour être communiqué efficacement, Device Update l’envoie à l’appareil dans un format détaché, également appelé mini manifeste de mise à jour. Un mini manifeste contient des métadonnées sur le manifeste de mise à jour que peut utiliser l’agent Device Update pour télécharger le manifeste de mise à jour complet et en vérifier l’authenticité.

L’exemple suivant montre un mini manifeste de mise à jour :

{
  "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="
      }
    }
  }
}

Contenu connexe