Sdílet prostřednictvím

Manifest aktualizace služby Azure Device Update pro IoT Hub

  • Článek

Tento článek popisuje data manifestu aktualizace, která služba Azure Device Update pro IoT Hub odesílá do zařízení během nasazování aktualizací. Manifest aktualizace je serializovaný objekt řetězce JSON obsahující metadata o aktualizaci, která se má nainstalovat.

Služba Device Update používá k odeslání manifestu aktualizace technologie Plug and Play IoT a kryptograficky ho podepíše, aby agent služby Device Update mohl ověřit jeho pravost. Další informace o tom, jak se manifest aktualizace používá k bezpečné instalaci obsahu, naleznete v tématu Zabezpečení služby Device Update.

Import manifestu vs. aktualizačního manifestu

Manifest aktualizace se liší odmanifestho

  • Manifest importu je soubor JSON, který popisuje aktualizaci, která se má importovat do služby Device Update. Každý, kdo vytvoří aktualizaci pro službu Device Update, vytvoří odpovídající soubor manifestu importu.
  • Manifest aktualizace je objekt řetězce JSON, který během aktualizace předává informace agentu Device Update. Služba Device Update automaticky vygeneruje manifest aktualizace zahrnutím některých stejných vlastností definovaných v manifestu importu.

Každý typ manifestu má vlastní schéma a verzi schématu. Další informace o schématu manifestu importu naleznete v tématu Schéma importu manifestu služby Device Update.

Aktualizace schématu manifestu

Schéma JSON manifestu aktualizace verze 4 je hostované na SchemaStore.org.

Příklad aktualizace manifestu

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

Manifest úplné vs. miniaktualizačního manifestu

Pokud je manifest aktualizace příliš velký, aby se efektivně komunikoval, služba Device Update ho odešle do zařízení v odpojeném formátu, kterému se také říká manifest miniaktualizační aktualizace. Mini manifest obsahuje metadata o manifestu aktualizace, který může agent aktualizace zařízení použít ke stažení manifestu úplné aktualizace a ověření jeho pravosti.

Následující příklad ukazuje manifest mini update:

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

Související obsah