Compartilhar via

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

  • Artigo

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

A Atualização de Dispositivo usa o IoT Plug and Play para enviar o manifesto de atualização e assiná-lo de maneira criptográfica a fim de que o agente da Atualização de Dispositivo possa verificar a autenticidade dele. Para saber como o manifesto de atualização é usado na instalação segura de conteúdos, confira Segurança da Atualização de Dispositivo.

Manifesto de importação e 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 que será importada para a Atualização de Dispositivo. A pessoa que cria a atualização para o serviço de Atualização de Dispositivo também cria o arquivo do manifesto de importação correspondente.
  • O manifesto de atualização é um objeto de cadeia de caracteres JSON que comunica informações ao agente da 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 o próprio esquema e versão de esquema. Para saber mais sobre o esquema do manifesto de importação, confira Esquema do manifesto de importação da Atualização de Dispositivo.

Atualizar esquema de manifesto

A versão 4 do esquema JSON do manifesto de atualização pode ser encontrada 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: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 de atualização completa vs mini

Se um manifesto de atualização for muito grande para ser comunicado de maneira eficiente, a Atualização de Dispositivo o enviará ao dispositivo em um formato destacado, também chamado de mini manifesto de atualização. Um mini manifesto contém metadados sobre o manifesto de atualização que o agente da Atualização de Dispositivo pode usar para baixar o manifesto de atualização completo e verificar a autenticidade dele.

Este exemplo 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údo relacionado