Guia de solução de problemas de Atualização de Dispositivo para IoT a fim de importar atualizações de proxy

Este documento fornece etapas de solução de problemas e uma tabela de mensagens de erro que você pode encontrar ao importar atualizações de proxy para a Atualização de Dispositivo para Hub IoT.

Mensagens de erro

Mensagem de erro Como solucionar os problemas
Nenhum manifesto de importação foi encontrado neste upload. A extensão de arquivo para manifestos de importação é .importmanifest.json Pelo menos um manifesto de importação é necessário para que uma atualização seja importada para a Atualização de Dispositivo para Hub IoT. Uma atualização de proxy pode ter um manifesto de importação pai e um número de manifestos de importação filho referenciados a partir do pai.

Um possível motivo para esse erro é que você tem manifestos de importação válidos, mas eles não têm a extensão .importmanifest.json no final do nome do arquivo. Essa extensão é necessária para que os manifestos de importação sejam reconhecidos pelo processo de importação no portal do Azure. Se a extensão estiver correta, você deverá revisar o esquema de cada manifesto de importação em sua atualização para ver se existem problemas. Saiba mais sobre manifestos de importação.
Esse upload não tem um manifesto pai necessário. A extensão de arquivo para manifestos de importação é .importmanifest.json Uma atualização de proxy pode ter um manifesto de importação pai e um número de manifestos de importação filho referenciados a partir do pai. Um manifesto pai deve ser incluído quando as atualizações filho estão sendo importadas, pois ele contém informações necessárias sobre essas atualizações filho.

Um possível motivo para esse erro é que você tem um manifesto de importação pai válido, mas ele não têm a extensão .importmanifest.json no final do nome do arquivo. Essa extensão é necessária para que os manifestos de importação sejam reconhecidos pelo processo de importação no portal do Azure. Se a extensão estiver correta, você deverá revisar o esquema de cada manifesto de importação pai para ver se existem problemas. Saiba mais sobre manifestos de importação.
Esse upload contém [n] manifestos pai. Somente uma é permitida. Exclua os manifestos que você não deseja usar e tente carregar novamente. Uma atualização de proxy pode ter um manifesto de importação pai e um número de manifestos de importação filho referenciados a partir do pai. Somente um manifesto pai pode ser incluído para uma determinada atualização, embora possa haver qualquer número de manifestos de importação filho. Se você observar esse erro junto a uma lista de arquivos de manifesto de importação, cada um desses arquivos terá informações indicando que é um manifesto de importação pai.

Para resolver esse problema, primeiro determine qual manifesto de importação pai corresponde à atualização que você está importando e remova qualquer outra para que haja apenas um manifesto de importação pai. Saiba mais sobre manifestos de importação.
O upload está faltando um ou mais dos manifestos secundários listados no arquivo pai (“parentimportfile.importmanifest.json”). Adicione os manifestos secundários necessários para esses IDs de atualização Uma atualização de proxy pode ter um manifesto de importação pai e um número de manifestos de importação filho. O manifesto de importação pai inclui referências a todos os manifestos de importação filho em sua atualização. Se você observar esse erro, o manifesto de importação pai referencia um manifesto de importação filho para cada uma das IDs de atualização listadas, mas esses manifestos de importação filho não fazem parte da atualização.

Para resolver esse problema, você precisará adicionar cada um desses manifestos de importação filho à sua atualização ou remover as referências no manifesto de importação pai. Saiba mais sobre manifestos de importação.
O upload contém arquivos de manifesto filho (“childmanifest.importmanifest.json”) que não estão listados no pai. Exclua-o e tente novamente. Uma atualização de proxy pode ter um manifesto de importação pai e um número de manifestos de importação filho. O manifesto de importação pai inclui referências a todos os manifestos de importação filho em sua atualização. Se você observar esse erro, cada manifesto listado será um manifesto de importação filho que está presente na atualização, mas não é referenciado no manifesto de importação pai.

Para resolver esse problema, você precisará remover esses manifestos de importação filho. Ou você pode adicionar referências a eles no manifesto de importação pai. Saiba mais sobre manifestos de importação.
Faltavam alguns arquivos de atualização necessários. Inclua-os e tente fazer o upload novamente. Uma atualização de proxy pode ter vários manifestos de importação, cada um referenciando vários arquivos de atualização. Se um dos arquivos referenciados não estiver incluído ao importar sua atualização, você verá esse erro.

Para resolver esse problema, você precisará adicionar os arquivos que estão faltando ou remover as referências a esses arquivos do manifesto de importação que os inclui. Saiba mais sobre manifestos de importação.
O upload contém um ou mais arquivos que não estão listados no manifesto. Exclua os arquivos adicionais e tente fazer upload novamente. Uma atualização de proxy pode ter vários manifestos de importação, cada um referenciando vários arquivos de atualização. Você observará esse erro se tentar importar os arquivos de atualização que não são referenciados em um manifesto de importação.

Para resolver esse problema, remova os arquivos listados na mensagem de erro. Ou adicione uma referência para cada arquivo a um dos manifestos de importação. Saiba mais sobre manifestos de importação.
O upload contém nomes de arquivo duplicados. Exclua ou renomeie os arquivos para que cada nome seja exclusivo. Uma atualização pode conter vários arquivos, mas cada arquivo deve ter um nome de arquivo exclusivo. Você verá esse erro se tentar importar um arquivo de atualização que tem o mesmo nome.

Para resolver esse problema, remova ou renomeie os arquivos listados na mensagem de erro. Se você renomear um arquivo, altere também a referência associada para cada arquivo no manifesto de importação apropriado. Saiba mais sobre manifestos de importação.
Um ou mais manifesto de importação não foi formatado corretamente. Exclua o arquivo ou ajuste sua sintaxe e tente novamente. Se você observar esse erro, é porque há um problema com a forma como os manifestos de importação foram criados. Para resolver esse problema, revise cada manifesto de importação listado e verifique se não há problemas de esquema. Saiba mais sobre manifestos de importação.

Próximas etapas