Freigeben über

Azure Device Update for IoT Hub: Updatemanifest

  • Artikel

In diesem Artikel werden die Update-Manifestdaten beschrieben, die Azure Device Update for IoT Hub während der Update-Bereitstellung an Geräte sendet. Das Updatemanifest ist ein serialisiertes JSON-Zeichenfolgeobjekt, das Metadaten über das zu installierende Update enthält.

Device Update verwendet IoT Plug & Play, um das Updatemanifest zu senden, und signiert es kryptografisch, damit der Device Update-Agent die Authentizität überprüfen kann. Weitere Informationen dazu, wie das Updatemanifest zum sicheren Installieren von Inhalten verwendet wird, finden Sie unter Device Update-Sicherheit.

Importmanifest und Updatemanifest

Das Updatemanifest unterscheidet sich vom Device Update-Importmanifest..

  • Das Importmanifest ist eine JSON-Datei, die das Update beschreibt, das in Device Update importiert werden soll. Die Person, die das Update für Device Update erstellt, erstellt auch die entsprechende Importmanifestdatei.
  • Das Updatemanifest ist ein JSON-Zeichenfolgenobjekt, das während eines Updates Informationen an den Device Update-Agent übermittelt. Der Device Update-Service generiert das Manifest automatisch, indem er einige der im Importmanifest definierten Eigenschaften einbezieht.

Jeder Manifesttyp verfügt über ein eigenes Schema und eine eigene Schemaversion. Weitere Informationen zum Importmanifestschema finden Sie unter Importmanifestschema für Azure Device Update for IoT Hub.

Schema des Importmanifests

Das Updatemanifest JSON-Schema Version 4 wird bei SchemaStore.org gehostet.

Beispiel für ein Updatemanifest

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

Vollständiges Updatemanifest im Vergleich zu Miniupdatemanifest

Wenn ein Update-Manifest zu groß ist und so eine effiziente Kommunikation verhindert, sendet Device Update es in einem getrennten Format, das auch als Mini-Updatemanifest bezeichnet wird, an das Gerät. Ein Minimanifest enthält Metadaten für das Updatemanifest, mit denen der Device Update-Agent das vollständige Updatemanifest herunterladen und seine Authentizität überprüfen kann.

Im folgenden Beispiel ist eine Mini-Updatemanifest dargestellt:

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

Zugehöriger Inhalt