Megosztás a következőn keresztül:

Azure Device Update for IoT Hub frissítési jegyzék

  • Cikk

Ez a cikk azokat a frissítési jegyzékadatokat ismerteti, amelyeket az Azure Device Update for IoT Hub a frissítés üzembe helyezése során küld az eszközöknek. A frissítési jegyzék egy szerializált JSON-sztringobjektum, amely metaadatokat tartalmaz a telepíteni kívánt frissítésről.

Az Eszközfrissítés az IoT Plug and Play használatával küldi el a frissítési jegyzéket, és kriptográfiailag aláírja, hogy az eszközfrissítési ügynök hitelesíteni tudja annak hitelességét. A tartalom biztonságos telepítéséhez használt frissítési jegyzékről további információt az Eszközfrissítés biztonsága című témakörben talál.

Jegyzék importálása és frissítési jegyzék

A frissítési jegyzék eltér az eszközfrissítés importálási jegyzékétől.

  • Az importálási jegyzék egy JSON-fájl, amely leírja az eszközfrissítésbe importálandó frissítést. Aki létrehozza az Eszközfrissítés frissítését, az létrehozza a megfelelő importálási jegyzékfájlt.
  • A frissítési jegyzék egy JSON-sztringobjektum, amely információkat közöl az eszközfrissítési ügynökkel a frissítés során. Az Eszközfrissítés szolgáltatás automatikusan létrehozza a frissítési jegyzéket az importálási jegyzékben meghatározott tulajdonságok némelyikének beleszámításával.

Minden jegyzéktípus saját sémával és sémaverzióval rendelkezik. Az importálási jegyzéksémáról további információt az Eszközfrissítés importálási jegyzékséma című témakörben talál.

Jegyzékséma frissítése

A frissítési jegyzék JSON-séma 4-es verziója a SchemaStore.org található.

Példa frissítési jegyzékre

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

Teljes és mini frissítési jegyzék

Ha egy frissítési jegyzék túl nagy ahhoz, hogy hatékonyan lehessen kommunikálni, az Eszközfrissítés leválasztott formátumban, más néven mini frissítési jegyzékként küldi el az eszköznek. A mini jegyzék metaadatokat tartalmaz a frissítési jegyzékről, amellyel az eszközfrissítési ügynök letöltheti a teljes frissítési jegyzékfájlt, és ellenőrizheti annak hitelességét.

Az alábbi példa egy minifrissítési jegyzékfájlt mutat be:

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

Kapcsolódó tartalom