Compartilhar via

Solucionar problemas de códigos de erro do Hub IoT do Azure

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

400xxx Erros de solicitação inválida

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 400. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
400000 SolicitaçãoGenéricaInválida Um erro genérico de solicitação incorreta. Verifique o formato e os parâmetros da solicitação.
400001 InvalidProtocolVersion Não há suporte para a versão do protocolo especificada na solicitação. Atualize a solicitação para usar uma versão de protocolo com suporte.
400002 DeviceInvalidResultCount O número de resultados retornados pelo dispositivo é inválido. Verifique se o dispositivo retorna o número correto de resultados.
400003 Operação Inválida A operação solicitada não é válida. Verifique se a operação tem suporte para o dispositivo.
400004 ArgumentInvalid Um ou mais argumentos na solicitação são inválidos. Confira os argumentos da solicitação para fins de correção.
400005 ArgumentNull Um ou mais argumentos necessários são nulos. Verifique se todos os argumentos necessários são fornecidos.
400006 IotHubFormatError O formato da solicitação não é válido. Verifique se o formato da solicitação está correto.
400007 ErroDeSerializacaoDaEntidadeDeArmazenamentoDoDispositivo A entidade de armazenamento do dispositivo não pôde ser serializada ou desserializada. Verifique o formato de serialização e os dados.
400008 BlobContainerValidationError O contêiner de blob especificado não é válido. Verifique o nome e as permissões do contêiner de blob.
400009 ImportWarningExistsError Há um aviso de importação existente. Examine os avisos de importação e resolva-os.
400010 InvalidSchemaVersion A versão do esquema especificada não é válida. Atualize a versão do esquema para uma versão com suporte.
400011 DeviceDefinedMultipleTimes O dispositivo é definido várias vezes. Verifique se o dispositivo só é definido uma vez.
400012 Erro de Desserialização Houve um erro ao desserializar a solicitação. Verifique o formato da solicitação e os dados para assegurar que estejam corretos.
400013 BulkRegistryOperationFailure Falha na operação de registro em massa. Examine os detalhes da operação em massa e tente novamente.
400014 DefaultStorageEndpointNotConfigured O ponto de extremidade de armazenamento padrão não foi configurado. Configure o ponto de extremidade de armazenamento padrão.
400015 InvalidFileUploadCorrelationId A ID de correlação de upload de arquivo não é válida. Verifique a correção do ID de correlação de upload do arquivo.
400016 ExpiredFileUploadCorrelationId A ID de correlação de upload de arquivo expirou. Obtenha uma nova ID de correlação de upload de arquivo.
400017 InvalidStorageEndpoint O ponto de extremidade de armazenamento especificado não é válido. Verifique se o ponto de extremidade de armazenamento está correto.
400018 InvalidMessagingEndpoint O endpoint de mensagens especificado não é válido. Confira se o ponto de extremidade do sistema de mensagens está correto.
400019 InvalidFileUploadCompletionStatus O status de conclusão do upload de arquivo não é válido. Verifique se o status de conclusão do upload do arquivo está correto.
400020 InvalidStorageEndpointOrBlob Ao tentar criar um blob durante o upload de arquivo, o armazenamento de blobs responde com Forbidden, Unauthorized, NotFound ou BadRequest. Verifique as permissões e a existência do blob storage.
400021 SolicitaçãoCancelada A solicitação foi cancelada. Tente novamente a solicitação.
400022 InvalidStorageEndpointProperty A propriedade de ponto de extremidade de armazenamento especificada não é válida. Verifique se as propriedades do ponto de extremidade de armazenamento estão corretas.
400023 EtagDoesNotMatch A ETag especificada na solicitação não corresponde à ETag atual do recurso. Atualize o ETag na solicitação para corresponder ao ETag atual.
400024 RequestTimedOut A solicitação atingiu o tempo limite. Tente novamente a solicitação.
400025 UnsupportedOperationOnReplica Não há suporte para a operação na réplica especificada. Examine os detalhes da operação e da réplica.
400026 Mensagem Nula A mensagem é nula. Verifique se a mensagem não é nula.
400027 ConnectionForcefullyClosedOnNewConnection O dispositivo se desconecta e relata Communication_Error como o ConnectionStatusChangeReason quando se usa o SDK do .NET e o tipo de transporte MQTT. Ocorre falha na operação de dispositivo gêmeo para a nuvem (como por exemplo, nas propriedades relatadas de leitura ou patch) ou na invocação do método direto 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, portanto, o Hub IoT fecha a conexão anterior. O Hub IoT não permite que mais de um cliente se conecte usando a mesma identidade. Verifique se cada cliente se conecta ao Hub IoT usando sua própria identidade.
400028 InvalidDeviceScope O escopo do dispositivo especificado não é válido. Confira o escopo do dispositivo para fins de correção.
400029 ConnectionForcefullyClosedOnFaultInjection As conexões existentes serão fechadas com esse erro durante as atualizações de serviço e plataforma. Espera-se que as novas tentativas sejam bem-sucedidas de imediato. Repita a operação
400030 ConnectionRejectedOnFaultInjection Novas conexões e tentativas imediatas de repetição serão rejeitadas com esse erro durante as atualizações de serviço e plataforma. Repita a operação
400031 Tipo de Autenticação de Endpoint Inválido O tipo de autenticação de ponto de extremidade especificado não é válido. Confira o tipo de autenticação do ponto de extremidade para fins de correção.
400032 ManagedIdentityNotEnabled A identidade gerenciada não está habilitada. Habilite a identidade gerenciada.
400035 ChaveDePolíticaInválida A chave de política especificada não é válida. Verifique a chave da política para verificar se está correta.
400036 BulkRegenerateDeviceKeyOperationFailure Ocorreu falha na operação de chave do dispositivo de regeneração em massa. Examine os detalhes da operação.

Erros de roteamento 4001xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4001. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
400100 InvalidRouteTestInput A entrada de teste de rota especificada não é válida. Verifique a entrada de teste de rota para verificar a exatidão.
400101 InvalidSourceOnRoute A origem especificada na rota não é válida. Confira a origem na rota para fins de correção.
400102 RoutingNotEnabled O roteamento não está habilitado. Habilitar o roteamento.
400103 InvalidContentEncodingOrType A codificação de conteúdo ou o tipo especificado não é válido. Verifique se a codificação ou o tipo de conteúdo estão corretos.

Erros de módulos 4003xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4003. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
400301 CannotRegisterModuleToModule Não há suporte para a comunicação módulo a módulo. Em vez disso, use a comunicação de dispositivo para nuvem ou nuvem para dispositivo.
400302 TenantHubRoutingNotEnabled O roteamento do hub de locatários não está habilitado. Habilitar o roteamento do hub de locatários.

Erros de configurações 4004xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4004. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
400401 CondiçãoAlvoDeConfiguraçãoInválida A condição de destino especificada na configuração não é válida. Confira a condição do destino para fins de correção.
400402 InvalidConfigurationContent O conteúdo especificado na configuração não é válido. Verifique se o conteúdo da configuração está correto.
400403 NãoPodemModificarConteúdoDaConfiguraçãoImutável O conteúdo da configuração é imutável e não pode ser modificado. Em vez disso, crie uma nova configuração.
400404 ConfiguraçãoInválidaConsultaDeMétricasPersonalizadas A consulta de métricas personalizadas especificada na configuração não é válida. Confira a consulta de métricas personalizadas para fins de correção.

Erros de interfaces de gêmeo digital 4005xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4005. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
400501 DefiniçãoDeInterfacePnPInválida A definição de interface especificada não é válida. Verifique a definição de interface para verificar a exatidão.
400502 InvalidPnPDesiredProperties As propriedades desejadas especificadas não são válidas. Revise as propriedades desejadas para garantir a correção.
400503 InvalidPnPReportedProperties (Propriedades relatadas de PnP inválidas) As propriedades informadas não são válidas. Verifique as propriedades relatadas para garantir a correção.
400504 InvalidPnPWritableReportedProperties As propriedades relatadas graváveis especificadas não são válidas. Confira as propriedades informadas graváveis para fins de correção.
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. Confira o payload do gêmeo digital para fins de correção.
400507 InvalidDigitalTwinPatch O patch especificado para o gêmeo digital não é válido. Confira o patch do gêmeo digital para fins de correção.
400508 InvalidDigitalTwinPatchPath O caminho do patch especificado para o gêmeo digital não é válido. Confira o caminho do gêmeo digital para fins de correção.

Erros não autorizados 401xxx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 401. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
401000 GenericUnauthorized A solicitação não está autorizada. Verifique as credenciais de autorização.
401001 IotHubNotFound O Hub IoT especificado não foi encontrado. Verifique o nome e a região do Hub IoT.
401002 IotHubUnauthorizedAccess A solicitação não está autorizada a acessar o Hub IoT. Verifique as permissões e as políticas de acesso do Hub IoT.
401003 IotHubUnauthorized A solicitação não está autorizada a acessar o Hub IoT. Consulte erro IotHubUnauthorized 401003 para obter mais informações.
401004 ElasticPoolNotFound O pool elástico especificado não foi encontrado. Verifique o nome e a região do pool elástico.
401100 Modificação de Módulo de Sistema Acesso Não Autorizado O módulo do sistema não está autorizado a modificar o recurso. Verifique as permissões do módulo do sistema.

Erro 401003 IotHubUnauthorized

Nos logs, você poderá ver um padrão de dispositivos se desconectando com 401003 IoTHubUnauthorized, seguido por 404104 DeviceConnectionClosedRemotely e conectando-se de forma bem-sucedida logo em seguida.

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

  • Cabeçalho de autorização ausente
  • O IotHub '*' não contém o dispositivo especificado '*'
  • A regra de autorização '*' não permite acesso para '*'
  • Falha na autenticação deste dispositivo, renovação de token ou certificado e reconexão
  • A impressão digital não corresponde à configuração: Impressão digital: SHA1Hash=*, SHA2Hash=*; Configuração: ImpressãoDigitalPrimária=*, ImpressãoDigitalSecundária=*
  • A user@example.com entidade de segurança não está autorizada para GET em /exampleOperation devido a nenhuma permissão atribuída

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. So:

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

Ou, o Hub IoT não pôde autenticar o cabeçalho, a regra ou a chave de autenticação. Esse 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 do IoT para conexão usando a cadeia de conexão do dispositivo. O SDK do IoT regenera o novo token para se reconectar à expiração do token SAS.

O tempo de vida do token padrão é de 60 minutos entre SDKs; no entanto, para alguns SDKs, o tempo de vida 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 sobre o comportamento de desconexão do dispositivo MQTT com os 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 SDK do C, 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, verifique:

  • O token SAS ou outro token de segurança que você usa não expirou.
  • Para a autenticação de certificado X.509, o certificado de dispositivo ou o certificado de autoridade de certificação associado ao dispositivo não fica expirado. Para saber como registrar certificados de autoridade de certificação X.509 no 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 é bem formada para o protocolo que você usa. Para saber mais, confira Controlar o acesso ao Hub IoT usando a ID do Microsoft Entra.
  • A regra de autorização usada tem a 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 RBAC do Azure ao usuário. Por exemplo, um proprietário no Hub IoT pode atribuir a função "Proprietário de Dados do Hub IoT", que fornece todas as permissões. Tente essa função para resolver o problema de falta de permissão.

Observação

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

Muitas vezes, executar uma sincronização de tempo usando NTP ou reinicializar 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 diariamente, semanalmente ou mensalmente, dependendo da quantidade de descompasso das experiências do dispositivo. Se você não puder configurar uma sincronização NTP periódica em seu dispositivo, agende uma reinicialização periódica.

Erro 403xxx Proibido

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 403. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
403000 GenericForbidden A solicitação é proibida. Verifique as permissões de solicitação.
403001 IotHubSuspended O Hub IoT está suspenso. Verifique o status do Hub IoT.
403002 IotHubQuotaExceeded A cota do Hub IoT foi excedida. Consulte Erro 403002 IotHubQuotaExceeded para obter mais informações.
403003 JobQuotaExceeded A cota de trabalho foi excedida. Verifique as cotas e os limites do trabalho.
403004 DeviceMaximumQueueDepthExceeded Foi excedida a profundidade máxima da fila do dispositivo. Consulte Erro 403004 DeviceMaximumQueueDepthExceeded para obter mais informações.
403005 IotHubMaxCbsTokenExceeded O limite máximo de token cbs do Hub IoT foi excedido. Verifique os limites do token CBS do Hub IoT.
403006 Limite máximo de upload de arquivo ativo no dispositivo excedido O limite máximo de upload de arquivo ativo do dispositivo foi excedido. Consulte o erro 403006 DeviceMaximumActiveFileUploadLimitExceeded para obter mais informações.
403007 DeviceMaximumQueueSizeExceeded O tamanho máximo da fila do dispositivo foi excedido. Verifique o tamanho da fila do dispositivo.
403008 RoutingEndpointResponseForbidden Não é permitida a resposta do ponto de extremidade de roteamento. Verifique as permissões do endpoint de roteamento.
403009 TempoDeExpiraçãoDaMensagemInválido A hora de expiração da mensagem é inválida. Verifique as configurações de tempo de expiração da mensagem.
403010 OperationNotAvailableInCurrentTier A operação não está disponível na camada atual. Verifique a camada e os recursos do Hub IoT.
403011 KeyEncryptionKeyRevoked Foi revogada a chave de criptografia de chave. Confira o status da chave de criptografia de chave.
403012 Dispositivo Desabilitado O dispositivo foi desabilitado. Verifique o status do dispositivo.
403800 DeviceMaximumInflightMethodExceeded Foi excedido o limite máximo de método na disponibilização da versão piloto do dispositivo. Confira os limites do método na disponibilização da versão piloto do dispositivo.

Erro 403002 IotHubQuotaExceeded

Talvez você veja as solicitações para o Hub IoT falharem com o erro 403002 IotHubQuotaExceeded. E no portal do Azure, a lista de dispositivos do Hub IoT não é carregada.

Esse erro normalmente ocorre quando a cota de mensagens diárias para o Hub IoT é excedida. Para resolver esse erro:

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

Erro 403004 DeviceMaximumQueueDepthExceeded

Ao tentar enviar uma mensagem de nuvem para dispositivo, você pode ver que a solicitação falha com o erro 403004 ou DeviceMaximumQueueDepthExceeded.

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

O motivo mais provável pelo qual está atingindo esse limite é porque você está usando HTTPS para receber a mensagem, o que causa um pool contínuo usando ReceiveAsync, resultando na limitação do Hub IoT à solicitação.

O padrão com suporte para mensagens de nuvem para dispositivo com HTTPS é 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, alterne para AMQP ou MQTT para mensagens do tipo nuvem-para-dispositivo.

Como alternativa, aprimore a lógica do lado do dispositivo para concluir, rejeitar ou abandonar mensagens em fila imediatamente, encurte o tempo de vida ou então considere enviar menos mensagens. Para obter mais informações, consulte a seção Expiração da mensagem (vida útil) de Noções básicas sobre mensagens de nuvem para dispositivo de um hub IoT.

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

Erro 403006: Limite Máximo de Arquivos Ativos para Upload no Dispositivo Excedido

Você pode ver que sua solicitação de upload de arquivo falha com o código 403006 de erro ou DeviceMaximumActiveFileUploadLimitExceeded uma mensagem "Número de solicitações de upload de arquivo ativo não pode exceder 10".

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

Para resolver esse erro, verifique se o dispositivo pode notificar prontamente a conclusão do upload de arquivo do Hub IoT. Em seguida, tente reduzir o TTL do token SAS para a configuração de upload de arquivo.

Erros proibidos do modelo de dispositivo 4031xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4031. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
403100 DeviceModelMaxPropertiesExceeded O limite máximo de propriedades do modelo de dispositivo foi excedido. Verifique as propriedades do modelo de dispositivo.
403101 PropriedadesMáximasIndexáveisDoModeloDeDispositivoExcedidas O limite máximo de propriedades indexáveis do modelo de dispositivo foi excedido. Verifique as propriedades indexáveis do modelo de dispositivo.

Erros de NotFound 404xxx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 404. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
404000 GenericNotFound O recurso solicitado não foi encontrado. Verifique a ID do recurso e tente novamente.
404001 DeviceNotFound O dispositivo especificado não foi encontrado. Consulte erro 404001 DeviceNotFound para obter mais informações.
404002 JobNotFound O trabalho especificado não foi encontrado. Verifique a ID do trabalho e tente novamente.
404004 QuotaMetricNotFound A métrica de cota especificada não foi encontrada. Verifique a ID da métrica de cota e tente novamente.
404005 SystemPropertyNotFound A propriedade do sistema especificada não foi encontrada. Verifique a ID de propriedade do sistema e tente novamente.
404006 AmqpAddressNotFound O endereço AMQP especificado não foi encontrado. Verifique o endereço AMQP e tente novamente.
404007 RoutingEndpointResponseNotFound Não foi encontrada a resposta do ponto de extremidade de roteamento especificado. Verifique o ponto de extremidade de roteamento e tente novamente.
404008 CertificateNotFound O certificado especificado não foi encontrado. Verifique a ID do certificado e tente novamente.
404009 ElasticPoolTenantHubNotFound Não foi encontrado o Hub de Locatário do Pool Elástico especificado. Confira a ID do Hub de Locatário do Pool Elástico e tente novamente.
404010 ModuleNotFound O módulo especificado não foi encontrado. Verifique a ID do módulo e tente novamente.
404011 AzureTableStoreNotFound O Repositório de Tabelas do Azure especificado não foi encontrado. Verifique a ID do Repositório de Tabelas do Azure e tente novamente.
404012 IotHubFailingOver Ocorreu failover no Hub IoT. Verifique o status do Hub IoT e tente novamente.
404013 FeatureNotSupported Não há suporte para o recurso solicitado. Verifique a documentação do recurso e tente novamente.
404014 DigitalTwinInterfaceNotFound A interface do Gêmeo Digital especificada não foi encontrada. Confira a ID da interface do Gêmeo Digital e tente novamente.

404001 erro DispositivoNãoEncontrado

Durante uma comunicação de C2D (nuvem para dispositivo), como a mensagem C2D, a atualização de conexão ou o método direto, você poderia ver que ocorre falha ha operação com o erro 404001 DeviceNotFound.

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

Para resolver esse erro, registre a ID do dispositivo usada e tente novamente.

Erros 4041xx Modelo de dispositivo NotFound

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4041. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
404101 QueryStoreClusterNotFound O cluster do repositório de consultas especificado não foi encontrado. Verifique a ID do cluster do repositório de consultas e tente novamente.
404102 DeviceNotOnline O dispositivo especificado não está online. Consulte 404103 erro DeviceNotOnline para obter mais informações.
404104 DeviceConnectionClosedRemotely A conexão do dispositivo foi fechada remotamente. Consulte Erro 404104 DeviceConnectionClosedRemotely para obter mais informações.

erro 404103 DispositivoNãoOnline

Você pode ver que um método direto para um dispositivo falha com o erro 404103 DeviceNotOnline mesmo se o dispositivo estiver online.

Se você souber que o dispositivo está online e ainda receber o erro, então o erro ocorreu provavelmente 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 métodos diretos, consulte a seção Manipular um método direto em um dispositivo de Manipular um método direto em um dispositivo.

Erro 404104 DeviceConnectionClosedRemotely

Você pode ver que os dispositivos se desconectam em um intervalo regular (a cada 65 minutos, por exemplo) e você vê 404104 DeviceConnectionClosedRemotely nos logs de recursos do Hub IoT. Às vezes, você também vê 401003 IoTHubUnauthorized e um evento de conexão de dispositivo bem-sucedido ocorre menos de um minuto depois.

Ou os dispositivos se desconectam aleatoriamente e você vê 404104 DeviceConnectionClosedRemotely nos logs de recursos do Hub IoT.

Ou, muitos dispositivos se desconectam ao mesmo tempo, você vê um queda na Métrica de dispositivos conectados (connectedDeviceCount) e há mais 404104 DeviceConnectionClosedRemotely e 500xxx Erros internos nos Logs do Azure Monitor do que o normal.

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 padrão para o SDK C, o que pode levar a desconexões regulares. ** Para saber mais, consulte 401003 erro IoTHubUnauthorized.

Algumas outras possibilidades incluem:

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

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

Para resolver esse erro:

Observação

Recomendamos usar os SDKs do dispositivo IoT do Azure para gerenciar conexões de forma confiável. Para saber mais, confira Gerenciar reconexões de dispositivo para criar aplicativos resilientes

Erros 4043xx Configuração NotFound

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4043. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
404301 ConfiguraçãoNãoEncontrada A configuração especificada não foi encontrada. Verifique a ID de configuração e tente novamente.
404302 GroupNotFound O grupo especificado não foi encontrado. Verifique a ID do grupo e tente novamente.

Erros 4044xx PnP NotFound

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4044. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
404401 DigitalTwinModelNotFound O modelo de gêmeo digital especificado não foi encontrado. Verifique a ID do modelo de gêmeo digital e tente novamente.
404402 InterfaceNameModelNotFound O modelo de nome de interface especificado não foi encontrado. Verifique a ID do modelo de nome da interface e tente novamente.

Erros 405xxx MethodNotAllowed

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 405. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
405000 GenericMethodNotAllowed O método especificado não é permitido. Verifique o método e tente novamente.

Erros de Método Não Permitido do modelo de dispositivo 4051xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4051. A tabela a seguir lista os códigos de erro, 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. Verifique o estado do dispositivo e tente novamente.
405103 ImportDevicesNotSupported Não há suporte para a importação de dispositivos. Verifique as configurações de importação e tente novamente.
405104 BulkAddDevicesNotSupported Não há suporte para adicionar dispositivos em massa. Verifique as configurações de adição em massa e tente novamente.

Erros de conflito 409xxx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 409. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
409000 GenericConflict Ocorreu um conflito. Verifique a solicitação e tente novamente.
409001 DispositivoJáExiste O dispositivo especificado já existe. Consulte o erro 409001 DeviceAlreadyExists para obter mais informações.
409002 LinkCreationConflict Ocorreu um conflito durante a criação de um link. Consulte o erro 409002 de LinkCreationConflict para obter mais informações.
409003 CallbackSubscriptionConflict Ocorreu um conflito com a assinatura de retorno de chamada. Verifique as configurações de assinatura de retorno de chamada e tente novamente.

409001 DeviceAlreadyExists: erro dispositivo já existe

Ao tentar registrar um dispositivo no Hub IoT, você pode ver que a solicitação falha com o erro 409001 DeviceAlreadyExists.

Esse erro ocorre porque já existe um dispositivo com a mesma ID do dispositivo no Hub IoT.

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

Erro 409002 LinkCreationConflict

Você pode ver o erro 409002 LinkCreationConflict nos logs junto com a desconexão do dispositivo ou falha de mensagens da nuvem para dispositivo.

Geralmente, esse erro ocorre quando o Hub IoT detecta 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 em log.

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

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

Erros de conflito do modelo de dispositivo 4091xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4091. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
409101 ModeloJáExiste O modelo especificado já existe. Verifique a ID do modelo e tente novamente.
409102 DeviceLocked O dispositivo especificado está bloqueado. Verifique o status do dispositivo e tente novamente.
409103 DeviceJobAlreadyExists O trabalho do dispositivo especificado já existe. Verifique o ID da tarefa do dispositivo e tente novamente.
409104 JobAlreadyExists O trabalho especificado já existe. Verifique a ID do trabalho e tente novamente.

Erros de conflito dos módulos 4093xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4093. A tabela a seguir lista os códigos de erro, 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 a ID do módulo e tente novamente.

Erros 4094xx Conflito de configuração

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4094. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
409401 ConfigurationAlreadyExists A configuração especificada já existe. Verifique a ID de configuração e tente novamente.
409402 AplicarConfiguraçãoJáEmProgressoNoDispositivo O aplicativo de configuração especificado já está em andamento no dispositivo. Verifique o status do dispositivo e tente novamente.

Erros 4095xx Conflito de gêmeo digital

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 4095. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
409501 DigitalTwinModelAlreadyExists O modelo de gêmeo digital especificado já existe. Verifique a ID do modelo de gêmeo digital e tente novamente.
409502 DigitalTwinModelExistsWithOtherModelType O modelo digital gêmeo especificado existe com um tipo de modelo diferente. Verifique o tipo de modelo de gêmeo digital e tente novamente.
409503 InterfaceNameModeloJáExiste O modelo de nome de interface especificado já existe. Verifique a ID do modelo de nome da interface e tente novamente.

Erros 412xxx PreconditionFailed

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 412. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
412000 GenericPreconditionFailed Falha na pré-condição genérica. Verifique a solicitação e tente novamente.
412001 falha na pré-condição A pré-condição falhou. Verifique a solicitação e tente novamente.
412002 DeviceMessageLockLost O bloqueio de mensagem do dispositivo foi perdido. Consulte o erro 412002 DeviceMessageLockLost para obter mais informações.
412003 JobRunPreconditionFailed Falha na pré-condição da execução do trabalho. Verifique o status do trabalho e tente novamente.
412004 InflightMessagesInLink Há mensagens de bordo no link. Verifique o status do link e tente novamente.

Erro 412002 DeviceMessageLockLost

Ao tentar enviar uma mensagem de nuvem para dispositivo, você pode ver que a solicitação 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 gerará essa exceção.

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

Erros 413xxx Entidade de solicitação grande demais

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 413. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
413000 GenericRequestEntityTooLarge A entidade de solicitação é muito grande. Reduza o tamanho da entidade de solicitação e tente novamente.
413001 MessageTooLarge A mensagem é grande demais. Reduza o tamanho da mensagem e tente novamente.
413002 TooManyDevices Demasiados dispositivos estão sendo registrados. Reduza o número de dispositivos e tente novamente.
413003 TooManyModulesOnDevice Demasiados módulos estão sendo registrados no dispositivo. Reduza o número de módulos e tente novamente.
413101 ConfigurationCountLimitExceeded O limite de contagem de configurações foi excedido. Reduza o número de configurações e tente novamente.
413201 DigitalTwinModelCountLimitExceeded O limite de contagem de modelos de gêmeo digital foi excedido. Reduza o número de modelos de gêmeos digitais e tente novamente.
413202 InterfaceNameCompressionModelCountLimitExceeded O limite de contagem do modelo de compactação de nomes de interface foi excedido. Reduza o número de modelos de compactação de nomes de interface e tente novamente.

Erros 415xxx: tipo de mídia não suportado

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 415. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
415000 GenericUnsupportedMediaType Não há suporte para o tipo de mídia. Verifique o tipo de mídia e tente novamente.
415101 TipoDeDadosIncompatível O tipo de dados é incompatível. Verifique o tipo de dados e tente novamente.

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

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 429. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
429000 GenericTooManyRequests Foram feitas muitas solicitações. Reduza o número de solicitações e tente novamente.
429001 ThrottlingException Ocorreu uma exceção de limitação. Consulte a documentação de limites de restrição para obter mais informações.
429002 ThrottleBacklogLimitExceeded O número de solicitações que estão na lista de pendências devido à restrição excedeu o limite da lista de pendências. Reduza o número de solicitações e tente novamente. Consulte a documentação Controle de tráfego para obter mais informações sobre como o controle de tráfego funciona antes de enviar a resposta de limitação.
429003 ThrottlingBacklogTimeout As solicitações que foram colocadas na lista de pendências devido à limitação expiraram enquanto aguardavam na fila da lista de pendências. Reduza o número de solicitações e tente novamente.
429004 ThrottlingMaxActiveJobCountExceeded O número máximo de trabalhos ativos foi excedido. Reduza o número de trabalhos ativos e tente novamente.
429005 DeviceThrottlingLimitExceeded O limite de regulagem do dispositivo foi excedido. Reduza o número de solicitações do dispositivo e tente novamente.

Esses erros ocorrem quando você excede os limites de limitação da operação solicitada.

Você só pode monitorar o erro 429001 ThrottlingException por meio do Azure Monitor sob a métrica Número de Erros de Limitação. No momento, os outros erros de limitação não têm uma métrica associada, mas são registrados nos logs.

Para resolver esses erros, verifique se você está atingindo o limite de limitação comparando sua 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 as métricas de telemetria do dispositivo. Para obter informações sobre como usar métricas para ajudá-lo a monitorar o hub IoT, consulte Monitorar o Hub IoT do Azure.

O Hub IoT retorna 429001 ThrottlingException somente depois que o limite é violado por um período muito longo. Esse atraso ocorre para que suas mensagens não sejam removidas se o Hub IoT obtiver tráfego intermitente. Enquanto isso, o Hub IoT processa as mensagens na taxa de limitação da operação, o que pode ser lento se houver muito tráfego na lista de pendências. Para obter mais informações, consulte a seção Formatação de tráfego de cotas e limitação do IoT Hub.

Considere escalar verticalmente seu Hub IoT se você estiver chegando à cota ou limites de limitação.

Erros 499xxx Solicitação de cliente fechada

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 499. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
499000 ClientClosedRequest O cliente fechou a solicitação. Tente novamente depois.

Erros de servidor interno 500xxx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 500 ou menciona um erro de servidor. Algumas possibilidades são:

Código de erro Description
500001 ServerError Ocorreu um erro no lado do servidor.
500008 GenericTimeout O Hub IoT não pôde concluir a solicitação de conexão antes do tempo limite.
ServiceUnavailable (sem código de erro) O Hub IoT encontrou um erro interno.
InternalServerError (sem código de erro) O Hub IoT encontrou um erro interno.

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

Para reduzir os erros 5000xx, emita uma nova tentativa direto de um dispositivo. Para gerenciar tentativas automaticamente, use 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 repetições transitórias de falhas, consulte o tratamento transitório de falhas.

Se o problema persistir, verifique o Resource Health e o Status do Azure para ver se o Hub IoT tem um problema conhecido. Você também pode usar a função 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.

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 5003. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
500301 ModelRepoEndpointError O ponto de extremidade do repositório de modelo é inválido. Verifique o ponto de extremidade do repositório de modelos e tente novamente.
500302 ResolutionError Ocorreu um erro de resolução. Tente novamente depois.

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 5004. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
500401 IncapazDeBuscarCredenciais Não é possível buscar credenciais. Verifique as credenciais e tente novamente.
500402 IncapazDeBuscarInfoInquilino Não é possível buscar informações de locatário. Verifique as informações do locatário e tente novamente.
500403 UnableToShareIdentity Não é possível compartilhar a identidade. Verifique as configurações de compartilhamento de identidade e tente novamente.

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 5005. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
500501 IncapazDeExpandirInformaçõesDeDescoberta Não é possível expandir as informações de descoberta. Verifique as informações de descoberta e tente novamente.
500502 UnableToExpandComponentInfo Não é possível expandir as informações do componente. Verifique as informações do componente e tente novamente.
500503 UnableToCompressComponentInfo Não é possível compactar as informações do componente. Verifique as informações do componente e tente novamente.
500504 Não foi possível compactar as informações de descoberta Não é possível compactar as informações de descoberta. Verifique as informações de descoberta e tente novamente.
500505 OrphanDiscoveryDocument Documento de descoberta órfão encontrado. Verifique o documento de descoberta e tente novamente.

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 502. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
502000 GenericBadGateway Ocorreu um erro genérico de gateway incorreto. Tente novamente depois.

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 503. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
503000 ServiçoGenéricoIndisponível Ocorreu um erro de serviço genérico indisponível. Tente novamente depois.
503001 ServiceUnavailable O serviço está indisponível. Tente novamente depois.
503004 IotHubActivationFailed Falha na ativação do Hub IoT. Verifique o status do Hub IoT e tente novamente.
503005 ServerBusy O servidor está ocupado. Tente novamente depois.
503006 IotHubRestoring O Hub IoT está sendo restaurado. Tente novamente depois.
503008 ReceiveLinkOpensThrottled As aberturas de link de recebimento estão sendo limitadas. Tente novamente depois.

Erros de indisponibilidade do modelo de dispositivo 5031xx

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 5031. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
503101 ConnectionUnavailable A conexão não está disponível. Verifique a conexão e tente novamente.
503102 DispositivoIndisponível O dispositivo não está disponível. Verifique o status do dispositivo e tente novamente.

Erros 5032xx Configuração não disponível

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 5032. A tabela a seguir lista os códigos de erro, 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 O grupo não está disponível. Verifique o grupo e tente novamente.

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 5033. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

Código de erro Description Solução
503301 HostingServiceNotAvailable O serviço de hospedagem não está disponível. Tente novamente depois.

Você pode ver que suas solicitações para o Hub IoT falham com um erro que começa com 504. A tabela a seguir lista os códigos de erro, suas descrições e possíveis soluções.

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

Erro 504101 de Timeout do Gateway

Ao tentar invocar um método direto do Hub IoT para um dispositivo, você pode ver que a solicitação falha com o erro 504101 GatewayTimeout.

Esse 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 SDK do C# do Azure IoT (<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, emita uma nova tentativa ou atualização para a versão mais recente do SDK C# do IOT do Azure.

Conteúdo relacionado

  • Last updated on