Aracılığıyla paylaş


IoT Hub için Azure Cihaz Güncelleştirmesi güncelleştirme bildirimi

Bu makalede, IoT Hub için Azure Cihaz Güncelleştirmesi'nin güncelleştirme dağıtımı sırasında cihazlara gönderdiği güncelleştirme bildirimi verileri açıklanmaktadır. Güncelleştirme bildirimi, yüklenecek güncelleştirmeyle ilgili meta verileri içeren serileştirilmiş bir JSON dize nesnesidir.

Cihaz Güncelleştirmesi, güncelleştirme bildirimini göndermek için IoT Tak Çalıştır kullanır ve Cihaz Güncelleştirme aracısının orijinalliğini doğrulayabilmesi için bunu şifreli olarak imzalar. güncelleştirme bildiriminin içeriği güvenli bir şekilde yüklemek için nasıl kullanıldığı hakkında daha fazla bilgi için bkz . Cihaz Güncelleştirmesi güvenliği.

İçeri aktarma bildirimi ve güncelleştirme bildirimi

Güncelleştirme bildirimi, Cihaz Güncelleştirmesi içeri aktarma bildiriminden farklıdır.

  • İçeri aktarma bildirimi , Cihaz Güncelleştirmesi'ne aktaracak güncelleştirmeyi açıklayan bir JSON dosyasıdır. Cihaz Güncelleştirmesi için güncelleştirmeyi kim oluşturursa, ilgili içeri aktarma bildirimi dosyasını oluşturur.
  • Güncelleştirme bildirimi, bir güncelleştirme sırasında Cihaz Güncelleştirmesi aracısı ile bilgi iletişim kuran bir JSON dize nesnesidir. Cihaz Güncelleştirme hizmeti, içeri aktarma bildiriminde tanımlanan özelliklerin bazılarını ekleyerek güncelleştirme bildirimini otomatik olarak oluşturur.

Her bildirim türünün kendi şeması ve şema sürümü vardır. İçeri aktarma bildirimi şeması hakkında daha fazla bilgi için bkz . Cihaz Güncelleştirmesi içeri aktarma bildirimi şeması.

Bildirim şemasını güncelleştirme

Güncelleştirme bildirimi JSON şema sürüm 4 SchemaStore.org barındırılır.

Örnek güncelleştirme bildirimi

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

Tam ve mini güncelleştirme bildirimi

Güncelleştirme bildirimi verimli bir şekilde iletilemeyecek kadar büyükse, Cihaz Güncelleştirmesi bunu mini güncelleştirme bildirimi olarak da adlandırılan ayrılmış biçimde cihaza gönderir. Mini bildirim, Cihaz Güncelleştirme aracısının güncelleştirme bildiriminin tamamını indirmek ve özgünlüğünü doğrulamak için kullanabileceği güncelleştirme bildirimiyle ilgili meta veriler içerir.

Aşağıdaki örnekte bir mini güncelleştirme bildirimi gösterilmektedir:

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