Partilhar via

Manifesto de atualização da Atualização de Dispositivo do Azure para o Hub IoT

  • Artigo

Este artigo descreve os dados do manifesto de atualização que a Atualização de Dispositivo do Azure para Hub IoT envia aos dispositivos durante a implantação da atualização. O manifesto de atualização é um objeto de cadeia de caracteres JSON serializado que contém metadados sobre a atualização a ser instalada.

A Atualização de Dispositivo usa o IoT Plug and Play para enviar o manifesto de atualização e o assina criptograficamente para que o agente de Atualização de Dispositivo possa verificar sua autenticidade. Para obter mais informações sobre como o manifesto de atualização é usado para instalar conteúdo com segurança, consulte Segurança de atualização de dispositivo.

Manifesto de importação vs manifesto de atualização

O manifesto de atualização é diferente do manifesto de importação da Atualização de Dispositivo.

  • O manifesto de importação é um arquivo JSON que descreve a atualização a ser importada para a Atualização de Dispositivo. Quem cria a atualização para a Atualização de Dispositivo cria o arquivo de manifesto de importação correspondente.
  • O manifesto de atualização é um objeto de cadeia de caracteres JSON que comunica informações ao agente de Atualização de Dispositivo durante uma atualização. O serviço de Atualização de Dispositivo gera automaticamente o manifesto de atualização incluindo algumas das mesmas propriedades definidas no manifesto de importação.

Cada tipo de manifesto tem seu próprio esquema e versão do esquema. Para obter mais informações sobre o esquema de manifesto de importação, consulte Esquema de manifesto de importação de Atualização de Dispositivo.

Atualizar esquema de manifesto

O esquema JSON de manifesto de atualização versão 4 está hospedado em SchemaStore.org.

Exemplo de manifesto de atualização

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

Manifesto de atualização completo vs mini

Se um manifesto de atualização for muito grande para ser comunicado de forma eficiente, a Atualização de Dispositivo envia-o para o dispositivo em formato desanexado, também chamado de mini manifesto de atualização. Um mini manifesto contém metadados sobre o manifesto de atualização que o agente de Atualização de Dispositivo pode usar para baixar o manifesto de atualização completo e verificar sua autenticidade.

O exemplo a seguir mostra um mini manifesto de atualização:

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

Conteúdos relacionados