Condividi tramite

Aggiornamento dei dispositivi di Azure per hub IoT manifesto dell'aggiornamento

  • Articolo

Questo articolo descrive i dati del manifesto di aggiornamento inviati da Aggiornamento dispositivi di Azure per hub IoT ai dispositivi durante la distribuzione degli aggiornamenti. Il manifesto dell'aggiornamento è un oggetto stringa JSON serializzato contenente i metadati relativi all'aggiornamento da installare.

Aggiornamento dispositivi usa Plug and Play IoT per inviare il manifesto dell'aggiornamento e lo firma crittograficamente in modo che l'agente di Aggiornamento dispositivi possa verificarne l'autenticità. Per altre informazioni sull'uso del manifesto di aggiornamento per installare in modo sicuro il contenuto, vedere Sicurezza di Aggiornamento dispositivi.

Importare il manifesto e aggiornare il manifesto

Il manifesto dell'aggiornamento è diverso dal manifesto di importazione di Aggiornamento dispositivi.

  • Il manifesto di importazione è un file JSON che descrive l'aggiornamento da importare in Aggiornamento dispositivi. Chiunque crei l'aggiornamento per Device Update crea il file manifesto di importazione corrispondente.
  • Il manifesto dell'aggiornamento è un oggetto stringa JSON che comunica informazioni all'agente di Aggiornamento dispositivi durante un aggiornamento. Il servizio Aggiornamento dispositivi genera automaticamente il manifesto dell'aggiornamento includendo alcune delle stesse proprietà definite nel manifesto di importazione.

Ogni tipo di manifesto ha uno schema e una versione dello schema. Per altre informazioni sullo schema del manifesto di importazione, vedere Schema del manifesto di importazione di Aggiornamento dispositivi.

Aggiornare lo schema del manifesto

Lo schema JSON del manifesto di aggiornamento versione 4 è ospitato in SchemaStore.org.

Esempio di manifesto di aggiornamento

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

Manifesto completo e mini aggiornamento

Se un manifesto di aggiornamento è troppo grande per essere comunicato in modo efficiente, Aggiornamento dispositivo lo invia al dispositivo in formato scollegato , detto anche manifesto di mini aggiornamento. Un mini manifesto contiene i metadati relativi al manifesto di aggiornamento che l'agente di Aggiornamento dispositivi può usare per scaricare il manifesto dell'aggiornamento completo e verificarne l'autenticità.

L'esempio seguente mostra un mini manifesto di aggiornamento:

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

Contenuto correlato