IoT 中樞裝置更新的更新資訊清單

「IoT 中樞裝置更新」使用 IoT 隨插即用在部署期間將資料傳送至裝置。 其中一項資料是「更新資訊清單」，這是序列化 JSON 物件字串，包含待安裝更新的中繼資料。 也以密碼編譯方式簽署，可讓「裝置更新代理程式」驗證資料的真確性。 有關如何使用更新資訊清單安全地安裝內容的詳細資訊，請參閱裝置更新安全性。

匯入資訊清單與更新資訊清單

請務必了解「IoT 中樞裝置更新」中的匯入資訊清單與更新資訊清單概念之間的差異：

• 匯入資訊清單由建立相應更新的人員所建立。 其中描述將匯入「IoT 中樞裝置更新」中的更新內容。
• 更新資訊清單由「IoT 中樞裝置更新」服務使用匯入資訊清單中定義的一些屬性自動產生。 在更新過程中用於將相關資訊傳達給「裝置更新代理程式」。

每種資訊清單類型有其自己的結構描述和結構描述版本。

更新資訊清單結構描述

重要

更新資訊清單 JSON 結構描述第 4 版裝載於 SchemaStore.org。

更新資訊清單範例

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

完整與迷你更新資訊清單

當更新資訊清單超過特定大小，以致於無法有效率地傳達時，「IoT 中樞裝置更新」會以「分離」格式將資訊清單傳送至裝置，也稱為「迷你更新資訊清單」。 迷你資訊清單在技術上是更新資訊清單的中繼資料，且包含必要資訊，可讓裝置更新代理程式下載完整更新資訊清單並確認其真確性。

迷你更新資訊清單範例：

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