IoT Hub için Azure Cihaz Güncelleştirmesi içeri aktarma bildirimi şeması

Iot Hub için Azure Cihaz Güncelleştirmesi'ne bir güncelleştirmeyi aktardığınızda, güncelleştirmeyle ilgili önemli bilgileri tanımlayan ilişkili bir JSON içeri aktarma bildirim dosyası da gönderirsiniz. Bu makalede, JSON içeri aktarma bildirim dosyasını oluşturmak için kullanılan şema açıklanmaktadır.

İçeri aktarma bildirimi kavramları ve dosya yapısı hakkında daha fazla bilgi edinmek için bkz . IoT Hub içeri aktarma bildirimi için Azure Cihaz Güncelleştirmesi. Dosyanın nasıl oluşturulacağını öğrenmek için bkz . IoT Hub için Cihaz Güncelleştirmesi'ne aktarmak üzere güncelleştirme hazırlama.

Şema

İçeri aktarma bildirimi JSON şeması SchemaStore.org barındırılır ve aşağıdaki özelliklerden oluşur. Başka hiçbir özelliğe izin verilmez.

Nesne Güncelleştir

updateID nesnesi, her güncelleştirme için benzersiz bir tanımlayıcıdır.

Başka hiçbir özelliğe izin verilmez.

Örneğin:

{
  "updateId": {
    "provider": "Contoso",
    "name": "Toaster",
    "version": "1.0"
  }
}

Uyumluluk nesnesi

nesnesi, compatibility bu güncelleştirmenin uyumlu olduğu bir cihazın 1-5 özelliklerini açıklar. Her özellik bir string tür ad-değer çiftidir. Ad 1-32 karakter uzunluğunda ve değer 1-64 karakter uzunluğunda olmalıdır. Aynı uyumluluk özellikleri kümesini birden fazla güncelleştirme sağlayıcısı ve ad bileşimiyle kullanamazsınız.

Örneğin:

{
  "compatibility": [
    {
      "manufacturer": "Contoso",
      "model": "Toaster"
    }
  ]
}

Instructions nesnesi

instructions nesnesi güncelleştirme yükleme yönergelerini sağlar. Instructions nesnesi gerçekleştirilecek bir steps liste içerir. Başka hiçbir özelliğe izin verilmez.

Adımlar yürütülecek kod veya diğer güncelleştirmelere yönelik işaretçiler olabilir. Değer sağlanmayan inlinetype bir adım nesnesi varsayılan olarak ayarlanır.

Örneğin:

{
  "instructions": {
    "steps": [
      {
        "type": "inline",
        ...
      },
      {
        "type": "reference",
        ...
      }
    ]
  }
}

Satır içi adım nesnesi

inline Adım nesnesi, kod yürütme gerçekleştiren bir yükleme yönerge adımıdır.

Başka hiçbir özelliğe izin verilmez.

Örneğin:

{
  "steps": [
    {
      "description": "pre-install script",
      "handler": "microsoft/script:1",
      "handlerProperties": {
        "arguments": "--pre-install"
      },
      "files": [
        "configure.sh"
      ]
    }
  ]
}

Başvuru adımı nesnesi

reference Step nesnesi, başka bir güncelleştirmeyi yüklemeye yönelik bir yükleme yönerge adımıdır.

Başka hiçbir özelliğe izin verilmez.

Örneğin:

{
  "steps": [
    {
      "type": "reference",
      "updateId": {
        "provider": "Contoso",
        "name": "Toaster.HeatingElement",
        "version": "1.0"
      }
    }
  ]
}

Dosyalar nesnesi

Her files nesne, bir güncelleştirme içinde benzersiz olması gereken ikili, üretici yazılımı veya betik dosyası gibi bir güncelleştirme yükü dosyasıdır.

Başka hiçbir özelliğe izin verilmez.

Örneğin:

{
  "files": [
    {  
      "fileName": "full-image-file-name",
      "sizeInBytes": 12345,
      "hashes": {...},
      "relatedFiles": [
        {
          "fileName": "delta-from-v1-file-name",
          "sizeInBytes": 1234,
          "hashes": {
            "SHA256": "delta-from-v1-file-hash"
          },
          "properties": {...}
        }  
      ],
      "downloadHandler": {
        "id": "microsoft/delta:1"
        }
    }
  ]
}

Karmalar nesnesi

hashes nesnesi, anahtar olarak algoritma adlarını içeren base64 kodlu dosya karmaları içerir. En azından SHA-256 algoritması belirtilmelidir ve aracı tarafından destekleniyorsa diğer algoritmalar belirtilebilir. Karmayı doğru hesaplama örneği için AduUpdate.psm1 betiğindeki işleve bakınGet-AduFileHashes.

Diğer özelliklere izin verilir.

Örneğin:

{
  "hashes": {
    "sha256": "/CD7Sn6fiknWa3NgcFjGlJ+ccA81s1QAXX4oo5GHiFA="
  }
}

relatedFiles nesnesi

relatedFiles nesnesi, bir veya daha fazla birincil yük dosyasıyla ilgili bir dosya koleksiyonu içerir. Daha fazla bilgi için bkz . Birden çok güncelleştirme dosyası başvurmak için ilgili dosyalar özelliğini kullanma.

Diğer özelliklere izin verilir.

Örneğin:

"relatedFiles": [
  {
    "filename": "in1_in2_deltaupdate.dat",
    "sizeInBytes": 102910752,
    "hashes": {
      "sha256": "2MIldV8LkdKenjJasgTHuYi+apgtNQ9FeL2xsV3ikHY="
    },
    "properties": {
      "microsoft.sourceFileHashAlgorithm": "sha256",
      "microsoft.sourceFileHash": "YmFYwnEUddq2nZsBAn5v7gCRKdHx+TUntMz5tLwU+24="
    }
  }
],

downloadHandler nesnesi

nesnesi, downloadHandler ilgili dosyaların nasıl işlendiği belirtir.

Başka hiçbir özelliğe izin verilmez.

Örneğin:

"downloadHandler": {
  "id": "microsoft/delta:1"
}

İlgili içerik

• Kavramları ve bildirimi içeri aktarma
• İçeri aktaracak güncelleştirmeyi hazırlama
• Güncelleştirmeyi içeri aktarma