Compartilhar via

Solução de problemas do Serviço de Provisionamento de Dispositivos no Hub IoT do Azure

Os problemas de provisionamento de dispositivos IoT podem ser difíceis de solucionar, porque há muitos pontos possíveis de falhas, como falhas de atestado, falhas de registro, etc. Para saber mais sobre como usar o Azure Monitor com DPS, consulte Monitorar o Serviço de Provisionamento de Dispositivos no Hub IoT do Azure.

Códigos de erro comuns

Use esta tabela para entender e resolver erros comuns.

Código do Erro Descrição Código de Status HTTP
400 O corpo da solicitação não é válido. Por exemplo, ele não pode ser analisado ou o objeto não pode ser validado. 400 Formato inválido
401 O token de autorização não pode ser validado. Por exemplo, ele expirou ou não se aplica ao URI da solicitação. Esse código de erro também é retornado para os dispositivos como parte do fluxo de atestado do TPM. 401 Não Autorizado
404 A instância do Serviço de Provisionamento de Dispositivos ou um recurso (por exemplo, um registro) não existe. 404 Não Encontrado
405 O serviço cliente conhece o método de solicitação, mas o serviço de destino não reconhece esse método; por exemplo, uma operação rest está sem os parâmetros de ID de registro ou registro 405 Método Não Permitido
409 A solicitação não pôde ser concluída devido a um conflito com o estado atual da instância do Serviço de Provisionamento de Dispositivos de destino; por exemplo, o cliente já criou o ponto de dados e está tentando recriá-lo novamente. 409 Conflito
412 A Etag da solicitação não corresponde à Etag do recurso existente, de acordo com o RFC7232. 412 Falha na pré-condição
415 O servidor se recusa a aceitar a solicitação porque o formato de carga está em um formato sem suporte. Para obter formatos com suporte, consulte a API REST do Serviço de Provisionamento de Dispositivos do Hub IoT 415 Tipo de mídia não suportado
429 As operações estão sendo limitadas pelo serviço. Para obter os limites de serviço específicos, confira Limites do Serviço de Provisionamento de Dispositivos no Hub IoT. 429 Número excessivo de solicitações
500 Ocorreu um erro interno. Erro interno de servidor 500

Ações sugeridas

  • Se um dispositivo IoT Edge não puder ser iniciado e exibir a mensagem de erro failed to provision with IoT Hub, and no valid device backup was found dps client error, confira o erro do cliente DPS na documentação do IoT Edge (1.1).

  • Para os erros 401 Não Autorizado, 403 Proibido ou 404 Não Encontrado, execute um novo registro completo chamando a API de registro do DPS.

  • Para um erro 429, siga o padrão de repetição de Hub IoT que tem retirada exponencial com uma tremulação aleatória. Você pode seguir o cabeçalho de repetição após fornecido pelo SDK.

  • Para erros de servidor da série 500, tente novamente sua conexão usando credenciais armazenadas em cache ou uma chamada à API de Pesquisa de Status de Registro de Dispositivo.

Para obter práticas recomendadas relacionadas, como repetir operações, consulte Práticas recomendadas para implantações de dispositivo IoT em larga escala.

Próximas etapas