Partilhar via

Resolução de problemas de códigos de erro do Azure IoT Hub

Este artigo descreve as causas e soluções para códigos de erro comuns que você pode encontrar ao usar o Hub IoT.

Erros de pedido incorreto 400xxx

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 400. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
400000 GenericBadRequest Um erro genérico de pedido inválido. Verifique o formato e os parâmetros do pedido.
400001 VersãoDeProtocoloInválida A versão do protocolo especificada no pedido não é suportada. Atualize o pedido para usar uma versão de protocolo suportada.
400002 DeviceInvalidResultCount O número de resultados devolvidos pelo dispositivo é inválido. Garanta que o dispositivo devolve o número correto de resultados.
400003 Operação Inválida A operação solicitada não é válida. Verifique se a operação é suportada pelo dispositivo.
400004 ArgumentoInválido Um ou mais argumentos no pedido são inválidos. Verifique se os argumentos do pedido são corretos.
400005 ArgumentNull Um ou mais argumentos obrigatórios são nulos. Certifique-se de que todos os argumentos necessários são fornecidos.
400006 IotHubFormatError O formato do pedido não é válido. Verifique se o formato do pedido está correto.
400007 ErroDeSerializacaoDaEntidadeDeArmazenamentoDoDispositivo A entidade de armazenamento do dispositivo não podia ser serializada ou desserializada. Verifique o formato de serialização e os dados.
400008 BlobContainerValidationError O contentor de blob especificado não é válido. Verifique o nome do contentor do blob e as permissões.
400009 ImportWarningExistsError Existe um aviso de importação existente. Revise os avisos de importação e resolva-os.
400010 Versão de Esquema Inválida A versão do esquema especificada não é válida. Atualize a versão do esquema para uma versão suportada.
400011 DeviceDefinedMultipleTimes O dispositivo é definido várias vezes. Garante que o dispositivo só está definido uma vez.
400012 DeserializationError Houve um erro ao desserializar o pedido. Verifique o formato do pedido e os dados para garantir a correção.
400013 FalhaNaOperaçãoDeRegistoEmMassa A operação de registo em massa falhou. Revise os detalhes da operação em massa e tente novamente.
400014 DefaultStorageEndpointNotConfigured O endpoint de armazenamento por defeito não está configurado. Configure o endpoint de armazenamento predefinido.
400015 InvalidFileUploadCorrelationId O ID de correlação do upload do ficheiro não é válido. Verifique se o ID de correlação de upload do ficheiro está correto.
400016 ExpiredFileUploadCorrelationId (ID de correlação de upload de arquivo expirado) O ID de correlação de upload do ficheiro expirou. Obtenha um novo ID de correlação de upload de ficheiros.
400017 InvalidStorageEndpoint O endpoint de armazenamento especificado não é válido. Verifique se o endpoint de armazenamento está correto.
400018 InvalidMessagingEndpoint O endpoint de mensagens especificado não é válido. Verifique se o endpoint de mensagens está correto.
400019 InvalidFileUploadCompletionStatus O estado de conclusão do carregamento do ficheiro não é válido. Verifica o estado de conclusão do carregamento do ficheiro para verificar se está correto.
400020 InvalidStorageEndpointOrBlob Ao tentar criar um blob durante o upload do ficheiro, o armazenamento do blob responde com Forbidden, Unauthorized, NotFound ou BadRequest. Verifique as permissões de armazenamento e a existência do blob.
400021 PedidoCancelado O pedido foi cancelado. Repita o pedido.
400022 PropriedadeDePontoFinalDeArmazenamentoInválida A propriedade endpoint de armazenamento especificada não é válida. Verifique se as propriedades do endpoint de armazenamento são corretas.
400023 EtagDoesNotMatch O ETag especificado no pedido não corresponde ao ETag atual do recurso. Atualize o ETag no pedido para corresponder ao ETag atual.
400024 RequestTimedOut O pedido expirou. Repita o pedido.
400025 Operação Não Suportada em Réplica A operação não é suportada na réplica especificada. Revise os detalhes da operação e da réplica.
400026 NullMessage A mensagem é nula. Certifique-se de que a mensagem não é nula.
400027 LigaçãoForçadamenteFechadaEmNovaConexão O seu dispositivo desconecta-se e reporta Communication_Error como o ConnectionStatusChangeReason ao usar tipo de transporte .NET SDK e MQTT. Ou a sua operação de gêmeos entre dispositivos e a nuvem (como leitura ou patch das propriedades reportadas) ou a invocação direta do método falha com o código de erro 400027. Esse erro ocorre quando outro cliente cria uma nova conexão com o Hub IoT usando a mesma identidade, para que o Hub IoT feche a conexão anterior. O Hub IoT não permite que mais de um cliente se conecte utilizando a mesma identidade. Certifique-se de que cada cliente se liga ao IoT Hub usando a sua própria identidade.
400028 InvalidDeviceScope O âmbito do dispositivo especificado não é válido. Verifique a exatidão do âmbito do dispositivo.
400029 ConexãoFechadaForçadamenteNaInjeçãoDeFalha As ligações existentes serão encerradas com este erro durante as atualizações de serviço e plataformas. Espera-se que as tentativas tenham sucesso imediato. Repita a operação
400030 LigaçãoRejeitadaNaInjeção de Falha Novas conexões e tentativas de nova conexão imediatas serão rejeitadas com este erro durante as atualizações de serviço e plataforma. Repita a operação
400031 InvalidEndpointAuthenticationType O tipo de autenticação do endpoint especificado não é válido. Verifique se o tipo de autenticação do endpoint está correto.
400032 Identidade Gerida Não Ativada A identidade gerida não está ativada. Ativa a identidade gerida.
400035 InvalidPolicyKey A chave da apólice especificada não é válida. Verifique se a chave da apólice está correta.
400036 BulkRegenerateDeviceKeyOperationFailure A operação de regeneração em massa da chave de dispositivo falhou. Reveja os detalhes da operação.

4001xx Erros de roteamento

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4001. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
400100 InvalidRouteTestInput A entrada do teste de rota especificada não é válida. Verifique se a entrada do teste de rota está correta.
400101 InvalidSourceOnRoute A fonte especificada na rota não é válida. Verifique a origem no percurso para confirmar se está correta.
400102 RoutingNotEnabled O encaminhamento não está ativado. Ativar o encaminhamento.
400103 InvalidContentEncodingOrType A codificação ou tipo de conteúdo especificado não é válido. Verifique se a codificação ou o tipo de conteúdo estão corretos.

Erros dos Módulos 4003xx

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa com 4003. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
400301 Não é possível registar módulo para módulo A comunicação módulo para módulo não é suportada. Em vez disso, use comunicação dispositivo-para-nuvem ou nuvem-para-dispositivo.
400302 TenantHubRoutingNotEnabled O encaminhamento do hub do tenant não está ativado. Ativar o encaminhamento do hub do inquilino.

Erros de configuração do 4004xx

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4004. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
400401 InvalidConfigurationTargetCondition A condição alvo especificada na configuração não é válida. Verifique se a condição alvo está correta.
400402 ConteúdoDeConfiguraçãoInválido O conteúdo especificado na configuração não é válido. Verifique se o conteúdo da configuração está correto.
400403 CannotModifyImmutableConfigurationContent O conteúdo de configuração é imutável e não pode ser modificado. Crie uma nova configuração em vez disso.
400404 InvalidConfigurationCustomMetricsQuery A consulta de métricas personalizadas especificada na configuração não é válida. Verifique se a consulta de métricas personalizadas está correta.

Erros nas interfaces dos gémeos digitais 4005xx

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4005. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
400501 InvalidPnPInterfaceDefinition A definição da interface especificada não é válida. Verifique a definição da interface para verificar se está correta.
400502 InvalidPnPDesiredProperties As propriedades desejadas especificadas não são válidas. Verifique se as propriedades desejadas são corretas.
400503 InvalidPnPReportedProperties As propriedades reportadas especificadas não são válidas. Verifique se as propriedades reportadas são corretas.
400504 InvalidPnPWritableReportedProperties As propriedades graváveis especificadas não são válidas. Verifique se as propriedades graváveis reportadas são corretas.
400505 InvalidDigitalTwinJsonPatch O patch JSON especificado para o gémeo digital não é válido. Verifique a correção do patch JSON.
400506 InvalidDigitalTwinPayload A carga útil especificada para o gémeo digital não é válida. Verifique se a carga útil do gémeo digital está correta.
400507 InvalidDigitalTwinPatch O patch especificado para o gémeo digital não é válido. Verifique a correção do patch digital twin.
400508 InvalidDigitalTwinPatchPath O caminho do patch especificado para o gémeo digital não é válido. Verifica o caminho do patch digital twin para verificar se está correto.

401xxx Erros não autorizados

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 401. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
401000 GenericUnauthorized O pedido não está autorizado. Verifique as credenciais de autorização.
401001 IotHubNotFound O IoT Hub especificado não foi encontrado. Consulta o nome e a região do IoT Hub.
401002 IotHubUnauthorizedAccess A solicitação não está autorizada a aceder ao IoT Hub. Verifique as políticas de acesso e permissões do IoT Hub.
401003 IotHubUnauthorized O pedido não tem autorização para aceder ao IoT Hub. Consulte erro 401003 IotHubUnauthorized para mais informações.
401004 ElasticPoolNotFound A piscina elástica especificada não foi encontrada. Verifica o nome e a região da piscina elástica.
401100 SystemModuleModificarAcessoNãoAutorizado O módulo do sistema não está autorizado a modificar o recurso. Verifica as permissões do módulo do sistema.

401003: erro IotHubUnauthorized

Nos logs, pode ver um padrão de dispositivos a desligar-se com 401003 IoTHubUnauthorized, seguido de 404104 DeviceConnectionClosedRemotely, e depois a ligar-se com sucesso pouco depois.

Ou, as solicitações para o Hub IoT falham com uma das seguintes mensagens de erro:

  • Cabeçalho de Autorização ausente
  • IotHub '*' não contém o dispositivo especificado '*'
  • A regra de autorização '*' não permite o acesso a '*'
  • Falha na autenticação para este dispositivo, renovar token ou certificado e reconectar
  • A impressão digital não corresponde à configuração: Impressão digital: SHA1Hash=*, SHA2Hash=*; Configuração: PrimaryThumbprint=*, SecondaryThumbprint=*
  • Principal user@example.com não está autorizado para GET em /exampleOperation devido à ausência de permissões atribuídas

Esse erro ocorre porque, para MQTT, alguns SDKs dependem do Hub IoT para emitir a desconexão quando o token SAS expira para saber quando atualizá-lo. Então:

  1. O token SAS expira
  2. IoT Hub deteta a expiração e desliga o dispositivo com 401003 IoTHubUnauthorized
  3. O dispositivo completa a desconexão com 404104 DeviceConnectionClosedRemotely
  4. O SDK da IoT gera um novo token SAS
  5. O dispositivo se reconecta com o Hub IoT com êxito

Ou, o Hub IoT não conseguiu autenticar o cabeçalho, a regra ou a chave de autenticação. Este resultado pode ser devido a qualquer uma das razões citadas nos sintomas.

Para resolver esse erro, nenhuma ação será necessária se estiver usando o SDK da IoT para conexão usando a cadeia de conexão do dispositivo. O IoT SDK regenera o novo token para se reconectar na expiração do token SAS.

A vida útil padrão do token é de 60 minutos entre SDKs; no entanto, para alguns SDKs, a vida útil do token e o limite de renovação do token são configuráveis. Além disso, os erros gerados quando um dispositivo se desconecta e se reconecta na renovação do token diferem para cada SDK. Para saber mais e obter informações sobre como determinar qual SDK seu dispositivo está usando em logs, consulte a seção Comportamento de desconexão do dispositivo MQTT com SDKs do Azure IoT em Monitorar, diagnosticar e solucionar problemas de conectividade de dispositivo do Hub IoT do Azure.

Para desenvolvedores de dispositivos, se o volume de erros for uma preocupação, alterne para o C SDK, que renova o token SAS antes da expiração. Para AMQP, o token SAS pode ser atualizado sem desconexão.

Em geral, a mensagem de erro apresentada deve explicar como corrigir o erro. Se, por algum motivo, você não tiver acesso aos detalhes da mensagem de erro, certifique-se de:

  • O SAS ou outro token de segurança que utiliza não expirou.
  • Para autenticação de certificado X.509, o certificado do dispositivo ou o certificado da autoridade de certificação associado ao dispositivo não expirou. Para saber como registrar certificados de CA X.509 com o Hub IoT, consulte Tutorial: Criar e carregar certificados para teste.
  • Para autenticação de impressão digital do certificado X.509, a impressão digital do certificado do dispositivo é registrada no Hub IoT.
  • A credencial de autorização está bem formada para o protocolo que você usa. Para saber mais, consulte Controlar o acesso ao Hub IoT usando o Microsoft Entra ID.
  • A regra de autorização utilizada concede permissão para a operação solicitada.
  • Para as últimas mensagens de erro que começam com "principal...", esse erro pode ser resolvido atribuindo o nível correto da permissão do Azure RBAC ao usuário. Por exemplo, um Proprietário no Hub IoT pode atribuir a função "Proprietário de Dados do Hub IoT", que concede todas as permissões. Tente esta função para resolver o problema de falta de permissão.

Observação

Alguns dispositivos podem enfrentar um problema de desvio de tempo quando o tempo do dispositivo tem uma diferença do tempo do servidor que é maior do que cinco minutos. Esse erro pode ocorrer quando um dispositivo está se conectando a um hub IoT sem problemas por semanas ou até meses, mas depois começa a ter sua conexão continuamente recusada. O erro também pode ser específico para um subconjunto de dispositivos conectados ao hub IoT, uma vez que o desvio de tempo pode acontecer em taxas diferentes, dependendo de quando um dispositivo é conectado ou ligado pela primeira vez.

Muitas vezes, executar uma sincronização de tempo usando NTP ou reiniciar o dispositivo (que pode executar automaticamente uma sincronização de tempo durante a sequência de inicialização) corrige o problema e permite que o dispositivo se conecte novamente. Para evitar esse erro, configure o dispositivo para executar uma sincronização de tempo periódica usando NTP. Você pode agendar a sincronização para diariamente, semanalmente ou mensalmente, dependendo da quantidade de desvio que o dispositivo experimenta. Se não for possível configurar uma sincronização NTP periódica no dispositivo, agende uma reinicialização periódica.

403xxx Erros proibidos

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 403. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
403000 GenericForbidden O pedido é proibido. Verifica as permissões da solicitação.
403001 IotHubSuspended O IoT Hub está suspenso. Verifica o estado do IoT Hub.
403002 IotHubQuotaExceeded A quota do IoT Hub foi ultrapassada. Consulte erro 403002 de IotHubQuotaExceeded para mais informações.
403003 JobQuotaExceeded A quota de emprego foi ultrapassada. Verifique as quotas e limites de emprego.
403004 ProfundidadeMáximaDaFilaDoDispositivoExcedida A profundidade máxima da fila do dispositivo foi ultrapassada. Consulte o Erro 403004 DeviceMaximumQueueDepthExceeded para mais informações.
403005 IotHubMaxCbsTokenExceeded O limite máximo de tokens CBS do IoT Hub foi ultrapassado. Verifique os limites de tokens CBS do IoT Hub.
403006 DeviceMaximumActiveFileUploadLimitExceeded O limite máximo de upload de ficheiros ativos do dispositivo foi ultrapassado. Consulte erro 403006 DeviceMaximumActiveFileUploadLimitExceeded para mais informações.
403007 TamanhoMáximoDaFilaDoDispositivoExcedido O tamanho máximo da fila do dispositivo foi ultrapassado. Verifica o tamanho da fila do dispositivo.
403008 RoutingEndpointResponseForbidden A resposta do ponto final de roteamento está proibida. Verifica as permissões do endpoint de roteamento.
403009 InvalidMessageExpiryTime O tempo de validade da mensagem é inválido. Verifique as definições do tempo de expiração da mensagem.
403010 OperaçãoNãoDisponívelNaCamadaAtual A operação não está disponível no nível atual. Verifica o nível e as capacidades do IoT Hub.
403011 ChaveDeEncriptaçãoRevogada A chave de encriptação da chave foi revogada. Verifica o estado da chave de encriptação de chaves.
403012 DispositivoDesabilitado O dispositivo foi desativado. Verifica o estado do dispositivo.
403800 LimiteMáximoDeOperaçõesDoDispositivoExcedido O limite máximo do método em voo do dispositivo foi ultrapassado. Verifique os limites do método em voo do dispositivo.

Erro 403002 IotHubQuotaExceeded

Pode ver pedidos para o IoT Hub falharem com o erro 403002 IotHubQuotaExceeded. E no portal do Azure, a lista de dispositivos do hub IoT não carrega.

Esse erro normalmente ocorre quando a cota diária de mensagens para o hub IoT é excedida. Para resolver este erro:

Um trabalho de importação em massa também pode retornar esse erro quando o número de dispositivos registrados em seu hub IoT se aproxima ou excede o limite de cota para um hub IoT. Para saber mais, consulte a seção Solucionar problemas de tarefas de importação de Importar e exportar identidades de dispositivo do Hub IoT em massa.

Erro 403004 DeviceMaximumQueueDepthExceeded

Ao tentar enviar uma mensagem cloud-to-device, pode ver que o pedido falha com o erro 403004 ou DeviceMaximumQueueDepthExceeded.

A causa subjacente deste erro é que o número de mensagens enfileiradas para o dispositivo excede o limite de fila.

A razão mais provável pela qual você está atingindo esse limite é porque está usando HTTPS para receber a mensagem, o que leva a uma sondagem contínua usando ReceiveAsync, resultando na restrição da solicitação pelo Hub IoT.

O padrão suportado para mensagens da nuvem para o dispositivo com HTTPS são dispositivos conectados intermitentemente que verificam mensagens com pouca frequência (menos do que a cada 25 minutos). Para reduzir a probabilidade de atingir o limite da fila, altere para AMQP ou MQTT para mensagens da nuvem para o dispositivo.

Como alternativa, aprimore a lógica do lado do dispositivo para completar, rejeitar ou abandonar mensagens em fila rapidamente, reduzir o tempo de vida ou considerar o envio de menos mensagens. Para obter mais informações, consulte a seção Expiração de mensagem (tempo de vida) de Compreender as mensagens da nuvem para o dispositivo de um hub IoT.

Por fim, considere usar a API Purge Queue para limpar periodicamente as mensagens pendentes antes que o limite seja atingido.

Erro 403006 LimiteMáximoAtivoDeUploadDeFicheiroExcedido do Dispositivo

Pode ver que o seu pedido de upload falha com o código 403006 de erro ou DeviceMaximumActiveFileUploadLimitExceeded aparece a mensagem "Número de pedidos ativos de upload de ficheiros não pode exceder 10".

Este erro ocorre porque cada cliente de dispositivo é limitado para carregamentos de arquivos simultâneos. Você pode facilmente exceder o limite se seu dispositivo não notificar o Hub IoT quando os carregamentos de arquivos forem concluídos. Uma rede do lado do dispositivo não confiável geralmente causa esse problema.

Para resolver esse erro, certifique-se de que o dispositivo possa notificar imediatamente a conclusão do carregamento do arquivo do Hub IoT. Em seguida, tente reduzir o TTL do token SAS para a configuração de upload de arquivos.

4031xx Erro proibido do modelo do dispositivo

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa com 4031. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
403100 DispositivoModeloMaxPropriedades Ultrapassadas O limite máximo de propriedades do modelo do dispositivo foi ultrapassado. Verifica as propriedades do modelo do dispositivo.
403101 DeviceModelMaxIndexablePropertiesExceeded O limite máximo de propriedades indexáveis do modelo de dispositivo foi ultrapassado. Verifica as propriedades indexáveis do modelo do dispositivo.

Erros 404xxx NotFound

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 404. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
404000 GenericNotFound O recurso solicitado não é encontrado. Verifica o ID do recurso e tenta novamente.
404001 DeviceNotFound O dispositivo especificado não é encontrado. Consulte o erro 404001 DeviceNotFound para mais informações.
404002 JobNotFound O emprego especificado não é encontrado. Verifique o ID do trabalho e tente novamente.
404004 QuotaMetricNotFound A métrica de quota especificada não é encontrada. Verifique o ID da métrica de quota e tente novamente.
404005 SystemPropertyNotFound A propriedade do sistema especificada não é encontrada. Verifique o ID da propriedade do sistema e tente novamente.
404006 AmqpAddressNotFound O endereço AMQP especificado não é encontrado. Verifique o endereço do AMQP e tente novamente.
404007 RoutingEndpointResponseNotFound A resposta especificada do endpoint de roteamento não é encontrada. Verifica o endpoint de roteamento e tenta novamente.
404008 CertificateNotFound O certificado especificado não é encontrado. Verifique o ID do certificado e tente novamente.
404009 ElasticPoolTenantHubNãoEncontrado O Elastic Pool Tenant Hub especificado não é encontrado. Verifique o ID do Tenant Hub da Piscina Elástica e tente novamente.
404010 MóduloNãoEncontrado O módulo especificado não é encontrado. Verifique o ID do módulo e tente novamente.
404011 AzureTableStoreNotFound A Loja de Tabelas do Azure especificada não é encontrada. Verifique o ID da Azure Table Store e tente novamente.
404012 IotHubFailingOver O IoT Hub está a falhar. Verifique o estado do IoT Hub e tente novamente.
404013 FuncionalidadeNãoSuportada A funcionalidade solicitada não é suportada. Consulte a documentação de funcionalidades e tente novamente.
404014 DigitalTwinInterfaceNãoEncontrada A interface Digital Twin especificada não é encontrada. Verifica o ID da interface Digital Twin e tenta novamente.

Erro 404001 DeviceNotFound

Durante uma comunicação cloud-to-device (C2D), como mensagem C2D, atualização gémea ou método direto, pode ver que a operação falha com erro 404001 DeviceNotFound.

A operação falhou porque o Hub IoT não consegue localizar o dispositivo. O dispositivo não está registado ou está desativado.

Para resolver este erro, registe o ID do dispositivo que utilizou e, em seguida, tente novamente.

4041xx Erro NotFound do modelo do dispositivo

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4041. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
404101 QueryStoreClusterNotFound O cluster de loja de consultas especificado não é encontrado. Verifique o ID do cluster do armazém de consultas e tente novamente.
404102 DeviceNotOnline O dispositivo especificado não está online. Consulte 404103 erro DeviceNotOnline para mais informações.
404104 ConexãoDoDispositivoFechadaRemotamente A ligação ao dispositivo foi encerrada remotamente. Consulte o erro 404104 DeviceConnectionClosedRemotely para mais informações.

erro 404103 DispositivoNãoOnline

Pode ver que um método direto para um dispositivo falha com o erro 404103 DeviceNotOnline , mesmo que o dispositivo esteja online.

Se você sabe que o dispositivo está online e ainda recebe o erro, então o erro provavelmente ocorreu porque o retorno de chamada do método direto não está registrado no dispositivo.

Para obter mais informações sobre como configurar seu dispositivo corretamente para retornos de chamada de método direto, consulte a seção Manipular um método direto em um dispositivo de Manipular um método direto em um dispositivo.

Erro 404104: DeviceConnectionClosedRemotely

Pode ver que os dispositivos se desligam a intervalos regulares (a cada 65 minutos, por exemplo) e vê 404104 DeviceConnectionClosedRemotely nos registos de recursos do IoT Hub. Às vezes, também pode ver 401003 IoTHubUnauthorized e um evento de conexão de dispositivo bem-sucedido menos de um minuto depois.

Ou, os dispositivos desconectam-se aleatoriamente, e pode ver 404104 DeviceConnectionClosedRemotely nos registos de recursos do IoT Hub.

Ou, muitos dispositivos desconectam-se ao mesmo tempo, vê-se uma queda na métrica de Dispositivos Conectados (connectedDeviceCount), e há mais 404104 DeviceConnectionClosedRemotely e 500xxx erros internos nos Registos de Monitorização do Azure do que o habitual.

Esse erro pode ocorrer porque o token SAS usado para se conectar ao Hub IoT expirou, o que faz com que o Hub IoT desconecte o dispositivo. A conexão é restabelecida quando o dispositivo atualiza o token. Por exemplo, o token SAS expira a cada hora por defeito para o C SDK, que pode levar a desconexões regulares. Para saber mais, consulte erro IoTHubUnauthorized 401003.

Algumas outras possibilidades incluem:

  • O dispositivo perdeu a conectividade de rede subjacente por mais tempo do que o MQTT keep-alive, resultando em um tempo-limite de inatividade remota. A configuração keep-alive MQTT pode ser diferente por cada dispositivo.
  • O dispositivo enviou um reset de nível TCP/IP, mas não enviou um reset de nível MQTT DISCONNECT de aplicação. Basicamente, o dispositivo fechou abruptamente a conexão de soquete subjacente. Às vezes, bugs em versões mais antigas do SDK do Azure IoT podem causar esse problema.
  • O aplicativo do lado do dispositivo travou.

Ou, o Hub IoT pode estar enfrentando um problema transitório. Para obter mais informações, consulte 500xxx Erros internos.

Para resolver este erro:

  • Consulte as orientações para o erro 401003 IoTHubUnauthorized.
  • Verifique se o dispositivo tem boa conectividade com o Hub IoT testando a conexão. Se a rede não for confiável ou intermitente, não recomendamos aumentar o valor de keep-alive porque isso pode resultar em uma deteção (por meio de alertas do Azure Monitor, por exemplo) demorando mais.
  • Use as versões mais recentes dos SDKs do Hub IoT do Azure.
  • Consulte as orientações para erros internos 500xxx.

Observação

Recomendamos utilizar SDKs de dispositivo IoT do Azure para gerir conexões de forma confiável. Para saber mais, consulte Gerenciar reconexões de dispositivos para criar aplicativos resilientes

4043xx Erros de Configuração NotFound

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4043. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
404301 ConfigurationNotFound A configuração especificada não é encontrada. Verifica o ID de configuração e tenta novamente.
404302 GrupoNãoEncontrado O grupo especificado não é encontrado. Verifica o ID do grupo e tenta novamente.

4044xx erros PnP Não Encontrado

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4044. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
404401 DigitalTwinModelNãoEncontrado O modelo de gémeo digital especificado não foi encontrado. Verifica o ID do modelo do gémeo digital e tenta novamente.
404402 InterfaceNomeModeloNãoEncontrado O modelo de nome da interface especificado não é encontrado. Verifique o nome da interface e o ID do modelo e tente novamente.

Erros 405xxx: Método Não Permitido

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 405. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
405000 GenericMethodNotAllowed O método especificado não é permitido. Verifica o método e tenta novamente.

4051xx Erro do modelo do dispositivo MethodNotAllowed

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4051. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
405102 OperaçãoNãoPermitidaNoEstadoAtual A operação não é permitida no estado atual. Verifica o estado do dispositivo e tenta novamente.
405103 ImportDevicesNotSupported Importar dispositivos não é suportado. Verifica as definições de importação e tenta novamente.
405104 BulkAddDevicesNãoSuportado Dispositivos de adição em massa não são suportados. Verifica as definições de adicionar em massa e tenta novamente.

409xxx Erros de conflito

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 409. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
409000 GenericConflict Ocorreu um conflito. Verifique o pedido e tente novamente.
409001 DispositivoJáExiste O dispositivo especificado já existe. Consulte o erro 409001 DeviceAlreadyExists para mais informações.
409002 LinkCreationConflict Ocorreu um conflito ao criar uma ligação. Consulte o erro LinkCreationConflict 409002 para mais informações.
409003 CallbackSubscriçãoConflito Ocorreu um conflito com a subscrição de callback. Verifique as definições da subscrição de callback e tente novamente.

Erro 409001 DeviceAlreadyExists

Ao tentar registar um dispositivo no IoT Hub, pode ver que o pedido falha com o erro 409001 DeviceAlreadyExists.

Este erro ocorre porque já existe um dispositivo com o mesmo ID de dispositivo no hub IoT.

Para resolver esse erro, use um ID de dispositivo diferente e tente novamente.

409002 Erro LinkCreationConflict

Pode ver o erro 409002 LinkCreationConflict nos logs juntamente com a desconexão do dispositivo ou falha de mensagem nuvem-para-dispositivo.

Geralmente, esse erro acontece quando o Hub IoT deteta que um cliente tem mais de uma conexão. Na verdade, quando uma nova solicitação de conexão chega para um dispositivo com uma conexão existente, o Hub IoT fecha a conexão existente com esse erro.

No caso mais comum, um problema separado (como o erro 404104 DeviceConnectionClosedRemotely) faz com que o dispositivo se desconecte. O dispositivo tenta restabelecer a conexão imediatamente, mas o Hub IoT ainda considera o dispositivo conectado. O Hub IoT fecha a conexão anterior e registra esse erro.

Ou, a lógica defeituosa do lado do dispositivo faz com que o dispositivo estabeleça a conexão quando uma já está aberta.

Para resolver esse erro, procure outros erros nos logs que você pode solucionar porque esse erro geralmente aparece como um efeito colateral de um problema diferente e transitório. Caso contrário, certifique-se de emitir uma nova solicitação de conexão somente se a conexão cair.

4091xx Erros de conflito de modelos de dispositivo

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4091. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
409101 ModeloJáExiste O modelo especificado já existe. Verifica o ID do modelo e tenta novamente.
409102 DeviceLocked O dispositivo especificado está bloqueado. Verifica o estado do dispositivo e tenta novamente.
409103 DeviceJobAlreadyExists A tarefa do dispositivo especificada já existe. Verifique o ID da tarefa do dispositivo e tente novamente.
409104 TrabalhoJáExiste O trabalho especificado já existe. Verifique o ID do trabalho e tente novamente.

Erros de conflito nos módulos 4093xx

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4093. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
409301 ModuleAlreadyExistsOnDevice O módulo especificado já existe no dispositivo. Verifique o ID do módulo e tente novamente.

4094xx Erros de conflito de configuração

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4094. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
409401 ConfigurationAlreadyExists A configuração especificada já existe. Verifica o ID de configuração e tenta novamente.
409402 ApplyConfigurationAlreadyInProgressOnDevice A aplicação de configuração especificada já está em curso no dispositivo. Verifica o estado do dispositivo e tenta novamente.

4095xx Erros de conflito entre gémeos digitais

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 4095. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
409501 DigitalTwinModelJáExiste O modelo de gémeo digital especificado já existe. Verifique o ID do modelo do gémeo digital e tente novamente.
409502 DigitalTwinModelExistsWithOtherModelType O modelo de gémeo digital especificado existe com um tipo de modelo diferente. Verifica o tipo de modelo do gémeo digital e tenta novamente.
409503 InterfaceNomeModeloJáExiste O modelo de nome de interface especificado já existe. Verifique o nome da interface e o ID do modelo e tente novamente.

412xxx erros de pré-condição falhada

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 412. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
412000 GeralPrecondiçãoFalhada Uma pré-condição genérica falhou. Verifique o pedido e tente novamente.
412001 Pré-condição falhou A pré-condição falhou. Verifique o pedido e tente novamente.
412002 DeviceMessageLockLost O bloqueio de mensagens do dispositivo foi perdido. Consulte o erro 412002 DeviceMessageLockLost para mais informações.
412003 TarefaExecuçãoPré-condiçãoFalhada A pré-condição de execução falhou. Verifique o estado da tarefa e tente novamente.
412004 InflightMessagesInLink Há mensagens em voo no link. Verifica o estado do link e tenta novamente.

412002 Erro de Bloqueio de Mensagem do Dispositivo Perdido

Ao tentar enviar uma mensagem cloud-to-device, pode ver que o pedido falha com o erro 412002 DeviceMessageLockLost.

Esse erro ocorre porque quando um dispositivo recebe uma mensagem de nuvem para dispositivo da fila (por exemplo, usando ReceiveAsync()), o Hub IoT bloqueia a mensagem por um tempo limite de bloqueio de um minuto. Se o dispositivo tentar concluir a mensagem depois que o tempo limite de bloqueio expirar, o Hub IoT lançará essa exceção.

Se o Hub IoT não receber a notificação dentro do tempo limite de bloqueio de um minuto, a mensagem será redefinida para o estado Enfileirado. O dispositivo pode tentar receber a mensagem novamente. Para evitar que o erro aconteça no futuro, implemente a lógica do lado do dispositivo para concluir a mensagem dentro de um minuto após o recebimento da mensagem. Este tempo limite de um minuto não pode ser alterado.

Erro 413xxx Entidade de solicitação demasiado grande

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 413. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
413000 GenericRequestEntityTooLarge A entidade do pedido é demasiado grande. Reduza o tamanho da entidade de pedido e tente novamente.
413001 Mensagem Demasiado Grande A mensagem é demasiado grande. Reduz o tamanho da mensagem e tenta novamente.
413002 DemasiadosDispositivos Demasiados dispositivos estão a ser registados. Reduza o número de dispositivos e tente novamente.
413003 TooManyModulesOnDevice (Demasiados módulos no dispositivo) Demasiados módulos estão a ser registados no dispositivo. Reduz o número de módulos e tenta novamente.
413101 LimiteDeContagemDeConfiguraçãoExcedido O limite de contagem de configurações foi ultrapassado. Reduza o número de configurações e tente novamente.
413201 DigitalTwinModelCountLimitExceeded O limite da contagem de modelos dos gémeos digitais foi ultrapassado. Reduza o número de modelos de gémeos digitais e tente novamente.
413202 InterfaceNomeCompressãoModeloContaLimiteUltrapassado O limite de contagem do modelo de compressão do nome da interface foi ultrapassado. Reduza o número de modelos de compressão de nomes de interface e tente novamente.

415xxx Erros de tipo de media não suportados

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 415. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
415000 TipoDeMídiaNãoSuportadoGenérico O tipo de media não é suportado. Verifica o tipo de media e tenta novamente.
415101 IncompatívelDataType O tipo de dado é incompatível. Verifique o tipo de dados e tente novamente.

429xxx Erros de exceção de limitação

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 429. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
429000 GenéricoDemasiadasRequisições Foram feitos demasiados pedidos. Reduza o número de pedidos e tente novamente.
429001 ThrottlingException Ocorreu uma exceção de limitação. Consulte a documentação sobre limites de controlo de capacidade para mais informações.
429002 ThrottleBacklogLimitExceeded O número de pedidos no backlog devido a limitações de tráfego ultrapassou o limite desse backlog. Reduza o número de pedidos e tente novamente. Consulte a documentação do Traffic shaping para mais informações sobre como funciona o traffic shaping antes de enviar a resposta de limitação.
429003 ThrottlingBacklogTimeout Pedidos que estavam em atraso devido a uma limitação expiraram enquanto aguardavam na fila de espera. Reduza o número de pedidos e tente novamente.
429004 RestriçãoMáximaContagemTarefasAtivasExcedida O número máximo de empregos ativos foi ultrapassado. Reduz o número de empregos ativos e tenta novamente.
429005 LimiteDispositivoExcedido O limite de desempenho do dispositivo foi ultrapassado. Reduza o número de pedidos do dispositivo e tente novamente.

Estes erros ocorrem quando ultrapassa os limites de restrição para a operação requisitada.

Só pode monitorizar o 429001 ThrottlingException erro através do Azure Monitor na métrica Número de Erros de Restrição. Atualmente, os outros erros de limitação não têm uma métrica associada, mas são captados nos registos.

Para resolver esses erros, verifique se você está atingindo o limite de limitação comparando a métrica de tentativas de envio de mensagem de telemetria com os limites especificados anteriormente. Você também pode verificar a métrica Número de erros de limitação . Para obter informações sobre essas métricas, consulte Métricas de telemetria de dispositivo. Para obter informações sobre como usar métricas para ajudá-lo a monitorar seu hub IoT, consulte Monitorar o Hub IoT do Azure.

O IoT Hub só regressa 429001 ThrottlingException depois de o limite ser ultrapassado por um período demasiado longo. Este atraso é feito para que as suas mensagens não sejam descartadas se o hub IoT receber um pico de tráfego. Entretanto, o Hub IoT processa as mensagens de acordo com a velocidade de acelerador da operação, que pode ser lenta caso haja demasiado tráfego no registo de tarefas pendentes. Para obter mais informações, consulte a seção Modelagem de tráfego de Cotas e limitação do Hub IoT.

Considere aumentar verticalmente o hub IoT se estiver a atingir os limites de quota ou de limitação.

499xxx Erros de pedidos encerrados pelo cliente

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 499. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
499000 PedidoFechadoPorCliente O cliente fechou o pedido. Tente novamente mais tarde.

500xxx Erros internos do servidor

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 500 ou menciona um erro do servidor. Algumas possibilidades são:

Código de Erro Description
500001 ServerError Ocorreu um erro do lado do servidor.
500008 GenericTimeout O IoT Hub não conseguiu concluir o pedido de ligação antes de expirar.
ServiceUnavailable (sem código de erro) O IoT Hub encontrou um erro interno.
IntralServerError (sem código de erro) O IoT Hub deparou com um erro interno.

Podem existir muitas causas para uma 500xxx resposta de erro. Em todos os casos, o problema é provavelmente transitório. Enquanto a equipe do Hub IoT trabalha duro para manter o SLA, pequenos subconjuntos de nós do Hub IoT podem, ocasionalmente, experimentar falhas transitórias. Quando o dispositivo tenta se conectar a um nó que está tendo problemas, você recebe esse erro.

Para mitigar o erro 5000xx, tente novamente a partir do dispositivo. Para gerenciar automaticamente as tentativas, certifique-se de usar a versão mais recente dos SDKs do Hub IoT do Azure. Para obter mais informações sobre as práticas recomendadas para tratamento e tentativas de falhas transitórias, consulte Tratamento de falhas transitórias.

Se o problema persistir, verifique a Integridade do Recurso e o Status do Azure para ver se o Hub IoT tem um problema conhecido. Você também pode usar o recurso de failover manual.

Se não houver problemas conhecidos e o problema continuar, entre em contato com o suporte para uma investigação mais aprofundada.

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 5003. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
500301 ModelRepoEndpointError O endpoint do repositório de modelos é inválido. Verifica o endpoint do repositório de modelos e tenta novamente.
500302 Erro de Resolução Ocorreu um erro de resolução. Tente novamente mais tarde.

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 5004. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
500401 IncapazDeBuscarCredenciais Não consigo obter credenciais. Verifique as credenciais e tente novamente.
500402 Não foi possível obter as informações do inquilino Não consigo obter informações sobre o inquilino. Verifique a informação do inquilino e tente novamente.
500403 Não PoderPartilharIdentidade Incapaz de partilhar identidade. Verifica as definições de partilha de identidade e tenta novamente.

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa com 5005. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
500501 Incapaz de Expandir Informação de Descoberta Não foi possível expandir a informação de descoberta. Verifique a informação de descoberta e tente novamente.
500502 UnableToExpandComponentInfo Impossível expandir a informação dos componentes. Verifica a informação dos componentes e tenta novamente.
500503 UnableToCompressComponentInfo Incapaz de comprimir a informação dos componentes. Verifica a informação dos componentes e tenta novamente.
500504 IncapazDeComprimirInformaçõesDeDescoberta Não é possível comprimir a informação de descoberta. Verifique a informação de descoberta e tente novamente.
500505 OrphanDiscoveryDocument Documento de descoberta de órfãos encontrado. Verifique o documento de descoberta e tente novamente.

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 502. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
502000 GenericBadGateway Ocorreu um erro genérico de gateway defectuoso. Tente novamente mais tarde.

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 503. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
503000 GenericServiceNão disponível Ocorreu um erro genérico de serviço indisponível. Tente novamente mais tarde.
503001 ServiçoNão disponível O serviço não está disponível. Tente novamente mais tarde.
503004 IotHubActivationFailed A ativação do IoT Hub falhou. Verifique o estado do IoT Hub e tente novamente.
503005 ServerBusy O servidor está ocupado. Tente novamente mais tarde.
503006 IotHubRestoring O IoT Hub está a ser restaurado. Tente novamente mais tarde.
503008 ReceiveLinkOpensThrottled As aberturas de links de receção são limitadas. Tente novamente mais tarde.

Erros de modelo de dispositivo não disponível 5031xx

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 5031. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
503101 LigaçãoNão disponível A ligação não está disponível. Verifique a ligação e tente novamente.
503102 DispositivoNão disponível O dispositivo não está disponível. Verifica o estado do dispositivo e tenta novamente.

5032xx Erros de indisponibilidade de configuração

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 5032. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
503201 ConfiguraçãoNãoDisponível A configuração não está disponível. Verifique a configuração e tente novamente.
503202 GroupNotAvailable (Grupo Não Disponível) O grupo não está disponível. Verifica o grupo e tente outra vez.

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 5033. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
503301 Serviço de AlojamentoNãoDisponível O serviço de alojamento não está disponível. Tente novamente mais tarde.

Pode ver que os seus pedidos ao IoT Hub falham com um erro que começa por 504. A tabela seguinte lista os códigos de erro, as suas descrições e possíveis soluções.

Código de Erro Description Solução
504000 GenericGatewayTimeout Ocorreu um erro genérico de timeout de gateway. Tente novamente mais tarde.
504101 GatewayTimeout O portal esgotou o tempo. Consulte o erro 504101 GatewayTimeout para mais informações.

504101 Erro GatewayTimeout

Ao tentar invocar um método direto do IoT Hub para um dispositivo, pode ver que o pedido falha com o erro 504101 GatewayTimeout.

Este erro ocorre porque o Hub IoT encontrou um erro e não pôde confirmar se o método direto foi concluído antes do tempo limite. Ou, ao usar uma versão anterior do Azure IoT C# SDK (<1.19.0), o link AMQP entre o dispositivo e o Hub IoT pode ser descartado silenciosamente devido a um bug.

Para resolver esse erro, tente novamente ou atualize para a versão mais recente do SDK do Azure IOT C#.

Conteúdo relacionado

  • Last updated on