Bagikan melalui


Manifes pembaruan Azure Device Update for IoT Hub

Artikel ini menjelaskan data manifes pembaruan yang dikirim Azure Device Update for IoT Hub ke perangkat selama penyebaran pembaruan. Manifes pembaruan adalah objek string JSON berseri yang berisi metadata tentang pembaruan yang akan diinstal.

Pembaruan Perangkat menggunakan IoT Plug and Play untuk mengirim manifes pembaruan, dan secara kriptografis menandatanganinya sehingga agen Pembaruan Perangkat dapat memverifikasi keasliannya. Untuk informasi selengkapnya tentang bagaimana manifes pembaruan digunakan untuk menginstal konten dengan aman, lihat Keamanan Pembaruan Perangkat.

Manifes impor vs manifes pembaruan

Manifes pembaruan berbeda dari manifes impor Pembaruan Perangkat.

  • Manifes impor adalah file JSON yang menjelaskan pembaruan untuk diimpor ke Pembaruan Perangkat. Siapa pun yang membuat pembaruan untuk Pembaruan Perangkat membuat file manifes impor yang sesuai.
  • Manifes pembaruan adalah objek string JSON yang mengkomunikasikan informasi ke agen Pembaruan Perangkat selama pembaruan. Layanan Pembaruan Perangkat secara otomatis menghasilkan manifes pembaruan dengan menyertakan beberapa properti yang sama yang ditentukan dalam manifes impor.

Setiap jenis manifes memiliki skema dan versi skemanya sendiri. Untuk informasi selengkapnya tentang skema manifes impor, lihat Skema manifes impor Pembaruan Perangkat.

Memperbarui skema manifes

Skema JSON manifes pembaruan versi 4 dihosting di SchemaStore.org.

Contoh manifes pembaruan

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

Manifes pembaruan penuh vs mini

Jika manifes pembaruan terlalu besar untuk dikomunikasikan secara efisien, Pembaruan Perangkat mengirimkannya ke perangkat dalam format yang dilepaskan , juga disebut manifes pembaruan mini. Manifes mini berisi metadata tentang manifes pembaruan yang dapat digunakan agen Pembaruan Perangkat untuk mengunduh manifes pembaruan lengkap dan memverifikasi keasliannya.

Contoh berikut menunjukkan manifes pembaruan mini:

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