Todos os produtos
Search
Central de documentação

IoT Platform:Logs do IoT Platform

Última atualização: Jul 03, 2026

Consulte os logs do IoT Platform no console do IoT Platform. Esses logs contêm registros de comunicação entre o IoT Platform, dispositivos e aplicações. Este tópico descreve os códigos de erro presentes nos logs do IoT Platform e os métodos para solucionar esses erros.

Tipos de log

A figura a seguir mostra os tipos de log de mensagens upstream.

上行消息日志

  1. Quando dispositivos enviam mensagens para o IoT Platform, o sistema gera logs de mensagens. Os tópicos usados para enviar as mensagens constam nos logs.

  2. Se diferentes módulos de negócios no IoT Platform processarem dados, o sistema gerará logs por módulo de negócios.

  3. Caso o recurso de encaminhamento de dados ou assinatura no lado do servidor envie mensagens aos consumidores, o sistema gerará logs desse recurso. Ao usar a assinatura no lado do servidor, configure um cliente Advanced Message Queuing Protocol (AMQP) ou Message Service (MNS) para receber as mensagens.

A figura a seguir mostra os tipos de log de mensagens downstream.

下行消息日志

  1. Se usuários chamarem operações de API para publicar mensagens, o sistema gerará logs dessas operações. Os nomes das operações de API constam nos logs.

  2. Quando diferentes módulos de negócios no IoT Platform processam dados, o sistema gera logs por módulo de negócios.

  3. Ao enviar mensagens do IoT Platform para dispositivos, o sistema gera os logs de mensagens correspondentes. Os tópicos usados para enviar as mensagens constam nos logs.

Consultar logs do IoT Platform

  1. Faça login no console do IoT Platform.

  2. Na página Overview, localize a instância que deseja gerenciar e clique em ID ou nome da instância.

  3. No painel de navegação à esquerda, escolha Maintenance > Device Log. Em seguida, clique em aba Cloud run log.

  4. Selecione um produto na lista suspensa Product. Especifique as condições de pesquisa e clique em Search.

    A tabela a seguir descreve as condições de pesquisa suportadas.

    Importante

    O conteúdo da condição de pesquisa é dividido em várias palavras quando a condição, como DeviceName ou palavra-chave, contém um dos seguintes caracteres especiais: , '";=()[]{}?@&<>/:\n\t\r. Nesse caso, a consulta falha e o sistema retorna a seguinte mensagem de erro: The parameter is invalid when you query logs.

    Condição de pesquisa

    Descrição

    DeviceName

    Insira um DeviceName. Pesquise os logs de um dispositivo pelo DeviceName.

    TraceId

    Insira um trace ID para pesquisar os logs de módulos interconectados.

    Keyword

    Insira uma palavra-chave para pesquisar logs que a contenham.

    MessageID

    Insira um message ID. O message ID é um identificador exclusivo que o IoT Platform gera para uma mensagem.

    A pesquisa por message ID só está disponível ao analisar mensagens upstream e downstream.

    Status

    Selecione um estado para pesquisar os logs relacionados. Valores válidos:

    • All

    • Successful: O código de status HTTP é 200.

    • Failed: O código de status HTTP não é 200.

    Workload type

    Selecione o tipo de negócio cujos logs você deseja consultar.

    Time range

    Selecione o intervalo de tempo no qual deseja consultar os logs.

Campos de log

A tabela a seguir descreve os campos de log.

Parâmetro

Descrição

Observações

Time

Hora em que uma entrada de log foi gerada.

Nenhuma.

TraceId

O trace ID. Use o trace ID para pesquisar módulos interconectados.

Nenhuma.

MessageID

O ID da mensagem.

Nenhuma.

DeviceName

O DeviceName do dispositivo.

Nenhuma.

Workload Type

Por padrão, todos os tipos de logs são exibidos. Especifique um valor para este campo para consultar um tipo específico de log.

Os itens a seguir descrevem os mapeamentos entre os valores válidos deste campo e os campos de log no Log Service após o despejo dos logs do IoT Platform no Log Service.

  • OTA Update: OTA

  • Data Parsing: ScriptParsing

  • TSL para verificação de dados TSL, chamadas de serviço TSL e mensagens TSL:ThingModel

  • Time Series Data Storage: HotDataStorage

  • Remote Configuration: RemoteConfig

  • Topological Relationship: ThingTopo

  • Device behavior: device

  • Device-to-cloud Messages: uplink

  • Cloud-to-device Message: downlink

  • API Calls: ApiService

  • Server-side Subscription: ServiceSubscribe

  • Device Shadow: DeviceShadow

  • Rules Engine: RuleEngine

  • Subscription: subscribe

  • Unsubscribe: unsubscribe

  • Thing Job: DeviceFileUpload

  • Other: Other

Identificador de negócio de primeiro nível que identifica um módulo de negócios.

Actions

Uma operação executada, nome de operação de API, método de serviço ou tópico de mensagem.

Para mais informações sobre nomes de operações de API, consulte Lista de APIs. Para mais informações sobre métodos de serviço ou tópicos, consulte Protocolo Alink.

Operações relacionadas:

  • Atualização OTA

    • OTAFirmwarePush: envia notificações quando uma atualização de firmware é iniciada, confirmada e concluída.

    • OTAFirmwareRequest: solicita informações sobre um pacote de atualização OTA.

    • OTAVersionReport: envia a versão do módulo OTA de um dispositivo.

    • OTAProgressReport: envia o progresso da atualização de um dispositivo.

  • Análise de dados

    • RawDataToProtocol: converte dados brutos em dados do protocolo Alink.

    • ProtocolToRawData: converte dados do protocolo Alink em dados brutos.

  • Envio de dados TSL

    • check: verifica os dados TSL enviados com base nas definições TSL.

    • Para mais informações sobre o parâmetro method no corpo da mensagem, consulte a seção "Usar tópicos para comunicação".

  • Gerenciamento de comportamento do dispositivo

    • online: conecta um dispositivo ao IoT Platform.

    • offline: desconecta um dispositivo do IoT Platform.

Identificador de negócio de segundo nível.

Content

O conteúdo do log pode conter os seguintes parâmetros:

  • TraceId: o trace ID usado para pesquisar módulos interconectados.

  • Message: a mensagem de erro. Este parâmetro consta em logs de operações com falha.

  • Params: os parâmetros da solicitação. Logs de tipos específicos incluem este parâmetro.

  • ResultData: o resultado da operação. Logs de operações que geram resultados incluem este parâmetro.

Se o formato de dados de um produto estiver definido como Custom, os logs de análise de dados TSL incluirão os valores hexadecimais dos dados brutos enviados pelos dispositivos.

Status

O código de status HTTP. O código de status 200 indica que uma chamada foi bem-sucedida. Outros códigos de status indicam que a chamada falhou.

Para mais informações sobre códigos de erro relacionados a operações de API, consulte Códigos de erro. Para mais informações sobre outros códigos de erro, consulte a seção a seguir.

Nenhuma.

Códigos de erro relacionados a comportamentos de dispositivo

Logs de comportamento do dispositivo são gerados quando dispositivos ficam online ou offline.

Código de erro

Descrição

Causa

Solução de problemas

200

O dispositivo fica online ou offline conforme esperado.

  • Offline: O dispositivo fecha a conexão com o IoT Platform.

  • Online: O dispositivo estabelece uma conexão com o IoT Platform.

Visualize os parâmetros Last Online e Current Status do dispositivo na página Device Details no console do IoT Platform.

1910

O dispositivo foi desconectado do IoT Platform porque nenhum heartbeat MQTT foi detectado durante o período de timeout especificado.

Se o IoT Platform não receber mensagens dentro do período keep-alive, o dispositivo será desconectado e precisará se reconectar ao servidor.

Para mais informações sobre heartbeats MQTT, consulte a seção "Mecanismo keep-alive do MQTT" em Limites.

Verifique se heartbeats MQTT foram detectados durante o período keep-alive.

1911

O dispositivo ficou offline porque a conexão TCP entre o dispositivo e o IoT Platform foi fechada.

  • Se um firewall ou gateway NAT no lado do dispositivo detectar uma conexão TCP inativa, o dispositivo fechará a conexão TCP.

  • A conexão TCP pode ser interrompida devido ao ambiente de rede complexo da Internet. Se o dispositivo conseguir se reconectar ao IoT Platform e o negócio não for afetado, ignore este código de erro.

Altere o ambiente de rede ou verifique as configurações de firewall e gateway para solucionar o problema. Por exemplo, desative o firewall.

Nota

Se a conexão TCP for interrompida frequentemente, use o TCPDUMP para obter arquivos de captura de pacotes e envie um ticket.

1913

O subdispositivo foi desconectado.

O gateway foi desconectado.

Verifique o motivo da desconexão do gateway usando o Log Service.

401

O dispositivo não tem permissões.

Ao adicionar uma relação topológica e autenticar o subdispositivo, a verificação da assinatura do subdispositivo falhou.

Verifique a assinatura gerada e a assinatura enviada usando o método de assinatura no protocolo Alink.

Para mais informações sobre o protocolo Alink, consulte Registrar dispositivos.

427

O dispositivo foi desconectado devido a uma exceção.

O dispositivo foi forçado a ficar offline porque o certificado do dispositivo está sendo usado por outro dispositivo.

O IoT Platform identifica um dispositivo apenas com base no certificado do dispositivo (ProductKey, DeviceName e DeviceSecret).

  • O mesmo certificado de dispositivo foi gravado em vários dispositivos.

  • A rede ou a fonte de alimentação do dispositivo é instável. O dispositivo se reconecta imediatamente ao IoT Platform após uma interrupção momentânea da rede ou falha de energia. Nesse caso, o IoT Platform identifica o dispositivo reconectado como um novo dispositivo. Mesmo que uma mensagem de erro seja retornada, o dispositivo pode funcionar conforme esperado.

  • Acesse a página Device Details no console e verifique a hora da última conexão do dispositivo ao IoT Platform. Determine se as mesmas informações de certificado de dispositivo foram usadas para conectar outro dispositivo ao IoT Platform.

  • Verifique se o ambiente de rede está estável usando um dos seguintes métodos:

520

Ocorreu um erro na sessão entre o subdispositivo e o IoT Platform.

  • A sessão especificada não existe porque o subdispositivo não está conectado ao IoT Platform ou já foi desconectado.

  • A sessão existe, mas não foi estabelecida usando o gateway atual.

Na aba Device List da página Devices, pesquise o dispositivo desejado e visualize seu status.

521

O dispositivo foi excluído.

O dispositivo foi excluído do IoT Platform.

Na aba Device List da página Devices, pesquise o dispositivo desejado para verificar se ele foi excluído.

522

O dispositivo está desativado.

O dispositivo está desativado no IoT Platform.

No console do IoT Platform, verifique se o dispositivo está no estado Disabled.

6100

O dispositivo não existe.

O dispositivo não foi criado ou foi excluído.

Na aba Device List da página Devices, pesquise o dispositivo desejado para verificar se ele existe.

6204

O dispositivo está desativado.

Se um dispositivo estiver desativado, não será possível gerenciá-lo. Por exemplo, não é possível adicionar relações topológicas, configurar propriedades do dispositivo ou chamar serviços do dispositivo.

No console do IoT Platform, verifique se o dispositivo está no estado Disabled.

6287

A assinatura é inválida.

A assinatura de um dispositivo conectado diretamente ou subdispositivo é inválida.

Verifique a assinatura gerada e a assinatura enviada usando o método de assinatura no protocolo Alink.

Para mais informações sobre o protocolo Alink, consulte Registrar dispositivos.

6288

O recurso de registro dinâmico do dispositivo está desativado.

A chave Dynamic Registration do produto ao qual o subdispositivo pertence está desligada.

Na página de details do produto ao qual o dispositivo pertence no console do IoT Platform, ative a chave Dynamic Registration.

6296

As informações da conta Alibaba Cloud não correspondem às informações da instância.

A instância não pertence à conta Alibaba Cloud.

No console do IoT Platform, verifique se a instância pertence à conta Alibaba Cloud.

6401

A relação topológica não existe.

A relação topológica não existe.

Faça login no console do IoT Platform e escolha Devices > Devices. Na página exibida, pesquise o dispositivo e visualize suas informações.

6402

O gateway é igual ao subdispositivo ao adicionar uma relação topológica.

Ao adicionar uma relação topológica, não é possível anexar o gateway a si mesmo como subdispositivo.

Verifique se o gateway é igual ao subdispositivo.

6619

O subdispositivo está anexado a outro gateway.

Se um subdispositivo já estiver anexado a um gateway, não será possível anexá-lo ao gateway atual.

Na aba Device Information da página de detalhes do dispositivo no console do IoT Platform, verifique se o subdispositivo já está anexado a um gateway.

2043

A autenticação do dispositivo falhou porque o token é inválido.

A verificação do token falhou durante a autenticação do dispositivo.

Verifique se o token expirou ou é inválido. Atualize ou recrie os tokens.

Códigos de erro relacionados a mensagens

Logs relacionados a mensagens são gerados nos seguintes cenários de negócios:

  • Dispositivos enviam mensagens para o IoT Platform.

  • O IoT Platform envia mensagens para dispositivos.

  • O mecanismo de regras encaminha mensagens usando o recurso de assinatura no lado do servidor ou encaminhamento de dados.

Código de erro

Descrição

Causa

Solução de problemas

1004

O formato dos dados que o dispositivo envia ao IoT Platform é inválido.

O formato dos dados upstream é inválido nos seguintes cenários de atualização OTA:

  • O dispositivo envia versões de módulos OTA para o IoT Platform.

  • O dispositivo solicita informações do pacote de atualização ao IoT Platform.

  • O dispositivo envia o progresso da atualização para o IoT Platform.

Verifique o formato dos dados upstream. Para mais informações sobre formatos de dados, consulte Atualizações OTA.

1901

Falha ao enviar a mensagem devido a condições de rede precárias, como congestionamento do buffer de gravação TCP.

O canal de dados entre o dispositivo e o servidor está bloqueado. Uma causa possível é a baixa velocidade de transmissão da rede ou a incapacidade do dispositivo de processar um grande número de mensagens.

Verifique as condições da rede e as capacidades de consumo de mensagens do dispositivo.

1902

Ocorreu uma exceção durante a transmissão da mensagem pela rede.

A transmissão da mensagem falhou devido a uma exceção de rede.

Verifique as condições da rede.

1903

O formato do tópico é inválido.

O formato do tópico da mensagem é inválido.

Verifique o formato do tópico.

1904

O IoT Platform recebeu uma resposta de revert-remote procedure call (RRPC) inválida.

A resposta RRPC recebida pelo IoT Platform não possui a solicitação RRPC correspondente. Esse erro pode ocorrer se a solicitação expirar.

Verifique se a resposta RRPC do dispositivo expirou.

1905

O IoT Platform não recebeu uma resposta RRPC dentro do período de timeout.

Após o IoT Platform enviar uma solicitação RRPC ao dispositivo, nenhuma resposta RRPC foi recebida dentro do período de timeout.

Verifique se o dispositivo respondeu à solicitação RRPC dentro do período de timeout.

1941

Falha na autenticação do dispositivo.

Falha na verificação do token.

Verifique e obtenha novamente o token. Em seguida, reinicie a solicitação.

1942

A comunicação de mensagens sofreu throttling.

Foram enviadas solicitações excessivas para o tópico.

Reduza a frequência de envio de mensagens de um único dispositivo ou entre em contato com o suporte técnico.

1950

Ocorreu uma exceção de conexão de rede durante a transmissão da mensagem.

Falha na transmissão da mensagem devido a uma exceção de rede.

Verifique as condições da rede.

1951

O tipo de resposta é desconhecido.

O dispositivo enviou uma mensagem de tipo desconhecido para o IoT Platform.

Verifique o tipo da mensagem enviada pelo dispositivo. Se estiver usando um Alibaba Cloud Link SDK, entre em contato com o suporte técnico ou envie um ticket.

6733

Não foi possível localizar o dispositivo com base nas informações de rede.

Falha ao localizar o dispositivo com base nas informações de rede especificadas.

Modifique as informações de rede e localize o dispositivo novamente.

6736

Não foi possível localizar o dispositivo com base no endereço IP.

Falha ao localizar o dispositivo com base no endereço IP especificado.

Modifique o endereço IP e tente localizar o dispositivo novamente.

6831

O tópico ou método de solicitação especificado não está em conformidade com o protocolo Alink.

O tópico para o qual o dispositivo envia dados ou o parâmetro method nos dados analisados não está em conformidade com o protocolo Alink.

Verifique se o tópico para o qual o dispositivo envia dados está em conformidade com o protocolo Alink. Verifique se o parâmetro method nos dados analisados está em conformidade com o protocolo Alink.

9200

O dispositivo está inativo.

O dispositivo não está ativado no console do IoT Platform. Após o registro de um novo dispositivo, ele só é ativado depois de se conectar ao IoT Platform e enviar dados.

Verifique o status do dispositivo no console do IoT Platform.

9201

  • O grupo de consumidores está offline.

  • O dispositivo está offline.

  • O grupo de consumidores associado à assinatura no lado do servidor está offline.

  • Ao chamar a operação Pub para enviar mensagens ao dispositivo, o dispositivo está offline.

  • Acesse o console do IoT Platform, escolha Message Forwarding > Server-side Subscription e clique em Consumer Groups. Na aba Consumer Groups, visualize o status of the consumer group. Na aba Consumption Logs, visualize os motivos pelos quais o grupo de consumidores foi conectado e desconectado do IoT Platform.

  • Acesse o console do IoT Platform e escolha Devices > Devices. Na página Devices, visualize o status do device.

9203

A assinatura no lado do servidor está offline.

Quando mensagens são encaminhadas para a assinatura no lado do servidor, o cliente AMQP ou MNS associado à assinatura está offline.

Certifique-se de que o cliente AMQP ou MNS associado à assinatura no lado do servidor esteja online.

9236

Falha na autenticação do tópico.

A permissão concedida no tópico é inválida.

Acesse a aba Topic Categories na página de detalhes do produto ao qual o dispositivo pertence no IoT Platform. Verifique se as permissões na coluna Allowed Operations da categoria de tópico à qual o tópico pertence são válidas.

  • A permissão Publish deve ser concedida nos tópicos que você deseja usar para publicar mensagens.

  • A permissão Subscribe deve ser concedida nos tópicos cujas mensagens você deseja assinar.

9307

Falha ao analisar a instrução SQL.

A sintaxe da instrução SQL ou o parâmetro é inválido.

Verifique a sintaxe da instrução SQL e os parâmetros.

9324

Ocorreu um erro de throttling.

O número de solicitações do dispositivo ou do locatário excedeu o limite.

Nota

Para mais informações sobre throttling, consulte a seção "Encaminhamento de dados" em Limites.

Reduza a frequência de envio de mensagens ou entre em contato com o suporte técnico.

9325

Falha ao encaminhar dados para o serviço de nuvem.

O serviço de nuvem de destino está indisponível.

Verifique se o serviço de nuvem de destino está disponível.

Um serviço de nuvem fica indisponível se houver pagamentos atrasados, instâncias excluídas ou se as permissões que o IoT Platform usa para acessar o serviço de nuvem forem excluídas.

9321

Os parâmetros são inválidos.

Os parâmetros de entrada são inválidos.

Verifique os parâmetros conforme solicitado.

9320

O payload é inválido.

O formato do payload enviado pelo dispositivo é inválido.

Verifique se o formato do payload é válido.

9331

Ocorreu um erro interno no serviço de nuvem de destino.

Ocorreu um erro interno no serviço de nuvem para o qual a mensagem foi enviada.

Verifique o código de erro na entrada de log e acesse o site oficial do serviço de nuvem correspondente para visualizar a causa do erro e a solução. Você também pode entrar em contato com o suporte técnico.

9332

A configuração do serviço de nuvem é inválida.

O destino de encaminhamento de dados especificado é inválido. Ocorreu um erro quando o IoT Platform tentou se conectar ao serviço de nuvem de destino.

Visualize a regra de encaminhamento de dados para verificar se a configuração do serviço de nuvem de destino é válida e se o recurso existe. Verifique o código de erro na entrada de log e acesse o site oficial do serviço de nuvem para visualizar a causa do erro e a solução.

9362

Ocorreu uma exceção durante a execução do script.

Ocorreu uma exceção de análise quando o mecanismo de regras executou um script. Possíveis causas:

  • Ocorreu uma exceção durante a execução do script de análise.

  • Ocorreu uma exceção ao chamar funções no script.

É possível determinar a causa do erro com base no conteúdo do log.

Verifique a sintaxe do script e as chamadas de função com base no conteúdo do log.

Para mais informações sobre como usar o script e as funções, consulte Sintaxe de script e Lista de funções.

9333

A permissão para acessar o serviço de nuvem é inválida.

A permissão concedida ao IoT Platform para acessar o serviço de nuvem de destino é inválida.

Verifique sua política do Alibaba Cloud Resource Access Management (RAM).

9389

O subdispositivo falhou ao enviar mensagens porque o gateway está offline.

O gateway ao qual o subdispositivo está anexado está offline.

Na aba Device List da página Devices, pesquise o gateway desejado e visualize seu status.

Certifique-se de que o gateway esteja online ou reinicie o gateway para conectar o subdispositivo ao IoT Platform.

9399

Ocorreu um erro interno desconhecido no servidor.

Ocorreu um erro interno no IoT Platform.

Entre em contato com o suporte técnico ou envie um ticket.

9600

O número de conexões em um grupo de consumidores excede o limite.

O IoT Platform não consegue processar um grande número de conexões. Para mais informações, consulte Limites em assinaturas no lado do servidor.

Feche conexões desnecessárias.

9601

O valor do heartbeat é inválido.

O valor do heartbeat não atende ao requisito. Para mais informações, consulte Limites em assinaturas no lado do servidor.

Especifique um valor de heartbeat válido.

9602

O IoT Platform fecha a conexão.

Esse erro pode ocorrer em cenários de balanceamento de carga e iteração do IoT Platform. O dispositivo deve ser capaz de se reconectar ao IoT Platform. Esse problema não afeta a continuidade do negócio.

Envie um ticket.

9650

A mensagem ACK expirou.

Nenhuma resposta foi enviada pelo receptor dentro do período de timeout. Portanto, a mensagem ACK do receptor expirou.

Verifique a lógica de processamento de mensagens do receptor.

9651

O receptor retorna ACK released.

O receptor retorna ACK released.

9652

O receptor retorna NACK.

O receptor retorna NACK.

Códigos de erro relacionados a modelos TSL

Logs relacionados a modelos TSL são gerados nos seguintes cenários de negócios:

  • Dispositivos enviam dados TSL.

  • O IoT Platform chama serviços TSL.

Se o formato de dados de um produto estiver definido como Custom, os logs relacionados a TSL incluirão os valores hexadecimais dos dados brutos enviados pelos dispositivos.

A tabela a seguir descreve os códigos de erro que podem ser retornados quando o IoT Platform chama serviços e configura propriedades.

Quando o IoT Platform chama um serviço, ele verifica se os parâmetros de entrada do serviço seguem a sintaxe definida no modelo TSL.

Código de erro

Descrição

Causa

Solução de problemas

Códigos de erro comuns

100000

Os parâmetros são inválidos.

Falha ao obter o ID da instância ao consultar as informações de configuração de um produto em uma instância pública ou Enterprise Edition do IoT Platform.

Verifique se você acessou uma instância do IoT Platform. Caso tenha acessado, envie um ticket para solução de problemas.

9201

O grupo de consumidores está offline.

O grupo de consumidores associado à assinatura no lado do servidor está offline.

Acesse o console do IoT Platform, escolha Message Forwarding > Server-side Subscription e clique em Consumer Groups. Na aba Consumer Groups, visualize o status of the consumer group. Na aba Consumption Logs, visualize os motivos pelos quais o grupo de consumidores foi conectado e desconectado do IoT Platform.

9200

O dispositivo não está ativado.

O dispositivo não está ativado no console do IoT Platform. Um dispositivo recém-registrado só é ativado depois de enviar dados ao IoT Platform.

Verifique o status do dispositivo no console do IoT Platform.

9237

Existem pagamentos atrasados para o serviço IoT Platform.

A conta Alibaba Cloud possui pagamentos atrasados.

No canto superior direito do console do IoT Platform, clique em Expenses e visualize o saldo da sua conta no User Center.

Certifique-se de que o saldo da sua conta seja suficiente. Caso contrário, os dispositivos do IoT Platform ficarão indisponíveis.

9389

O subdispositivo falhou ao enviar mensagens porque o gateway está offline.

O gateway ao qual o subdispositivo está anexado está offline.

Na aba Device List da página Devices, pesquise o gateway desejado e visualize seu status.

Certifique-se de que o gateway esteja online ou reinicie o gateway para conectar o subdispositivo ao IoT Platform.

6208

O dispositivo está desativado.

Após a desativação de um dispositivo, o IoT Platform não pode configurar propriedades ou chamar serviços do dispositivo.

Verifique o status do dispositivo no console do IoT Platform. Se o dispositivo estiver desativado, ative-o e tente novamente.

6300

O parâmetro method não existe quando o IoT Platform verifica os parâmetros de entrada com base no modelo TSL.

O parâmetro method exigido pelo protocolo Alink não existe nos parâmetros de entrada. Os parâmetros de entrada podem ser dados Alink padrão enviados pelo dispositivo ou o resultado da análise de dados personalizados enviados pelo dispositivo.

Visualize os logs do IoT Platform sobre relatório de propriedades do dispositivo e verifique os dados enviados pelo dispositivo. Você também pode visualizar os logs locais do dispositivo para verificar os dados enviados.

6206

Ocorreu um erro ao consultar o serviço.

Quando o IoT Platform chama um serviço, as informações sobre o serviço são consultadas. Esse erro ocorre se o serviço não existir.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, verifique se o serviço está definido no modelo TSL. Se estiver definido, verifique se os parâmetros de entrada do serviço contêm caracteres invisíveis.

6200

O script não existe.

Se o formato de dados de um produto estiver definido como Custom, o script é usado para analisar dados quando o IoT Platform chama o serviço de um dispositivo. Esse erro ocorre se você não definir um script de análise de dados.

Acesse a página de detalhes do produto no console do IoT Platform. Verifique se o script de análise de dados existe. Se existir, reenvie o script e tente novamente.

6201

O resultado da análise está vazio.

O script de análise de dados executa conforme esperado, mas retorna um resultado vazio. Por exemplo, o método rawDataToProtocol() retorna null e o método protocolToRawData() retorna null ou um array vazio.

Verifique o script para identificar a causa do erro.

6207

O formato dos dados é inválido.

Esse erro pode ocorrer quando o IoT Platform chama um serviço sincronamente ou quando o dispositivo envia dados.

Quando o IoT Platform chama um serviço sincronamente, esse erro pode ocorrer devido a um dos seguintes motivos:

  • O formato dos dados retornados pelo dispositivo é inválido.

  • O formato dos dados personalizados analisados é inválido.

  • O formato de dados dos parâmetros de entrada é inválido.

Para mais informações sobre o formato de dados válido exigido pelo serviço, consulte a documentação da API e as definições TSL. Para informações sobre o formato de dados exigido pelo protocolo Alink, consulte Protocolo Alink.

6330

O formato dos dados não está em conformidade com o formato definido do tipo Long.

Parâmetros ou propriedades do tipo Long estão definidos no modelo TSL. O formato de dados da mensagem não está em conformidade com o formato definido do tipo Long.

  • Visualize os logs gerados quando o dispositivo envia propriedades.

  • Visualize o modelo TSL no console do IoT Platform.

6335

O parâmetro na mensagem que o dispositivo envia como resposta à solicitação de configuração de propriedade não está vazio.

Quando o dispositivo responde à solicitação de configuração de propriedade enviada pelo IoT Platform, os dados de resposta indicados pelo campo data devem estar vazios.

  • Visualize os logs do IoT Platform sobre relatório de propriedades do dispositivo e verifique os dados enviados pelo dispositivo.

  • Verifique os dados enviados visualizando os logs locais do dispositivo.

6336

O valor do parâmetro time no modelo TSL é inválido.

Quando o dispositivo envia dados de propriedades TSL ou eventos TSL, o valor do parâmetro time nos dados não atende aos requisitos.

Importante

Um dispositivo só pode enviar dados de propriedades TSL e eventos TSL nas próximas 24 horas.

Verifique se o valor do parâmetro time nos dados enviados de propriedades TSL ou eventos TSL atende a todos os requisitos.

5490

O módulo TSL especificado não existe.

O módulo TSL personalizado especificado não existe.

  • No console do IoT Platform, visualize o identificador do módulo TSL personalizado e verifique se valores válidos foram especificados para os parâmetros necessários.

  • No console do IoT Platform, verifique se o módulo TSL personalizado especificado foi excluído.

5092

A propriedade não existe no modelo TSL.

A propriedade na mensagem upstream ou downstream não está definida no modelo TSL.

Importante

Para uma propriedade definida em um módulo TSL personalizado, você deve concatenar a propriedade com o identificador do módulo no formato {tsl.functionBlockId}:{tsl.properties.identifier}.

  • Visualize os logs gerados quando o dispositivo envia propriedades.

  • Visualize as propriedades no modelo TSL no console do IoT Platform.

5094

O serviço não existe no modelo TSL.

O serviço não está definido no modelo TSL ou os parâmetros do serviço são inválidos.

Importante

Para um serviço definido em um módulo TSL personalizado, você deve concatenar o serviço com o identificador do módulo no formato {tsl.functionBlockId}:{tsl.service.identifier}.

  • Visualize os logs gerados quando o dispositivo envia propriedades.

  • Visualize os serviços no modelo TSL no console do IoT Platform.

5096

O evento não existe no modelo TSL.

O evento não está definido no modelo TSL ou os parâmetros do evento são inválidos.

Importante

Para um evento definido em um módulo TSL personalizado, você deve combinar o evento com o identificador do módulo no formato {tsl.functionBlockId}:{tsl.event.identifier}.

  • Visualize os logs gerados quando o dispositivo envia propriedades.

  • Visualize os eventos no modelo TSL no console do IoT Platform.

Códigos de erro do sistema

5159

Ocorreu um erro quando o IoT Platform recuperou os dados de propriedade TSL.

Ocorreu uma exceção do sistema.

Envie um ticket.

5160

Ocorreu um erro quando o IoT Platform recuperou os dados de evento TSL.

5161

Ocorreu um erro quando o IoT Platform recuperou os dados de serviço TSL.

6661

Ocorreu um erro quando o IoT Platform consultou as informações do locatário.

6205

Ocorreu um erro quando o IoT Platform chamou o serviço.

26015

Ocorreu um erro quando o IoT Platform executou o script para analisar os dados.

A tabela a seguir descreve os códigos de erro gerados quando dispositivos falham ao enviar dados de propriedades e eventos.

Quando um dispositivo envia dados de propriedade ou evento, o IoT Platform verifica os dados da propriedade ou os parâmetros de entrada do evento com base no modelo TSL.

Código de erro

Descrição

Causa

Solução de problemas

Códigos de erro comuns

6106

O número de propriedades enviadas pelo dispositivo excede o limite.

Um dispositivo pode enviar até 200 propriedades por vez.

Visualize os logs do IoT Platform sobre relatório de propriedades do dispositivo e verifique o número de propriedades enviadas pelo dispositivo. Você também pode visualizar os logs locais do dispositivo para verificar os dados enviados.

6300

O parâmetro method não existe quando o IoT Platform verifica os parâmetros de entrada com base no modelo TSL.

O parâmetro method exigido pelo protocolo Alink não existe nos parâmetros de entrada. Os parâmetros de entrada podem ser dados Alink padrão enviados pelo dispositivo ou o resultado da análise de dados personalizados enviados pelo dispositivo.

Visualize os logs do IoT Platform sobre relatório de propriedades do dispositivo e verifique os dados enviados pelo dispositivo. Você também pode visualizar os logs locais do dispositivo e verificar os dados enviados.

6320

As informações da propriedade não existem quando o IoT Platform verifica os parâmetros de entrada com base no modelo TSL.

Falha ao localizar a propriedade especificada quando o sistema consultou os dados TSL do dispositivo.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, verifique se a propriedade especificada está definida no modelo TSL. Se não estiver definida, defina a propriedade.

6367

Quando o dispositivo envia dados de propriedades TSL ou eventos TSL, o valor do parâmetro time nos dados não atende aos requisitos.

Quando um dispositivo envia dados de propriedades TSL ou eventos TSL, apenas dados dos últimos 30 dias podem ser enviados.

Verifique se o valor do parâmetro time nos dados enviados de propriedades TSL ou eventos TSL atende a todos os requisitos.

6450

O parâmetro method não existe nos dados Alink.

O parâmetro method não existe nos dados Alink padrão. Os dados Alink padrão podem ser enviados diretamente pelo dispositivo ou convertidos a partir de dados personalizados enviados pelo dispositivo.

Visualize os logs do IoT Platform sobre relatório de propriedades do dispositivo e verifique se os dados enviados incluem o parâmetro method. Você também pode visualizar os logs locais do dispositivo.

6207

O formato dos dados é inválido.

Esse erro pode ocorrer quando o IoT Platform chama um serviço sincronamente ou quando o dispositivo envia dados.

Quando o dispositivo envia dados, esse erro pode ocorrer porque os dados Alink enviados pelo dispositivo ou os dados analisados usando o script não estão no formato JSON.

Para mais informações sobre o formato de dados exigido pelo protocolo Alink, consulte Protocolo Alink. Use o formato de dados necessário para enviar dados.

Códigos de erro do sistema

6452

Ocorreu um erro de throttling.

O throttling de tráfego foi acionado porque um número excessivo de solicitações foi enviado.

Envie um ticket.

6760

A cota de armazenamento do locatário foi excedida.

Ocorreu uma exceção do sistema.

Envie um ticket.

A tabela a seguir descreve os códigos de erro que podem ser retornados quando dispositivos falham ao responder a chamadas de serviço e solicitações de configuração de propriedade do IoT Platform.

Código de erro

Descrição

Causa

Solução de problemas

Códigos de erro comuns

460

Os parâmetros são inválidos.

Os parâmetros da solicitação são inválidos.

Envie um ticket.

500

Ocorreu um erro interno do sistema.

Ocorreu um erro desconhecido no IoT Platform.

Envie um ticket.

400

Ocorreu um erro de solicitação.

Ocorreu um erro desconhecido quando o IoT Platform chamou o serviço.

Envie um ticket.

429

Um número excessivo de solicitações foi enviado dentro de um período específico.

O throttling de tráfego foi acionado porque um número excessivo de solicitações foi enviado dentro de um período específico.

Envie um ticket.

Códigos de erro do sistema

6452

Ocorreu um erro de throttling.

O throttling de tráfego foi acionado porque um número excessivo de solicitações foi enviado.

Envie um ticket.

A tabela a seguir descreve os códigos de erro comuns relacionados a modelos TSL.

O IoT Platform verifica os parâmetros de entrada do serviço, os dados da propriedade e os parâmetros de entrada do evento com base no modelo TSL.

Código de erro

Descrição

Causa

Solução de problemas

Códigos de erro comuns

6321

O identificador da propriedade não existe no modelo TSL.

Ocorreu uma exceção do sistema.

Envie um ticket.

6317

O modelo TSL é inválido.

Ocorreu uma exceção do sistema.

Envie um ticket.

6332

O parâmetro de entrada não está em conformidade com as definições TSL.

Os parâmetros de entrada devem estar em conformidade com as definições TSL.

Acesse a página de detalhes do produto no console do IoT Platform. Visualize o modelo TSL na aba Define Feature. Verifique os parâmetros de entrada.

6302

O parâmetro não existe.

O IoT Platform falhou ao verificar os parâmetros de entrada do serviço com base no modelo TSL porque os parâmetros não foram incluídos na solicitação.

Acesse a página Product Details no console do IoT Platform. Visualize o modelo TSL na aba Define Feature. Verifique os parâmetros de entrada do serviço no modelo TSL e certifique-se de que todos os parâmetros necessários estejam configurados.

6306

O parâmetro de entrada não corresponde ao tipo de dados integer definido no modelo TSL.

Quando o IoT Platform verifica um parâmetro com base no modelo TSL, os seguintes erros podem ocorrer:

  • O tipo de dados do parâmetro é diferente do tipo de dados definido no modelo TSL.

  • O valor do parâmetro não está dentro do intervalo definido no modelo TSL.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL e certifique-se de que o parâmetro de entrada atenda aos requisitos do tipo de dados definido no modelo TSL.

6307

O parâmetro de entrada não corresponde ao tipo de dados floating-point de 32 bits definido no modelo TSL.

Quando o IoT Platform verifica um parâmetro com base no modelo TSL, os seguintes erros podem ocorrer:

  • O tipo de dados do parâmetro é diferente do tipo de dados definido no modelo TSL.

  • O valor do parâmetro não está no intervalo definido no modelo TSL.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL. Certifique-se de que o tipo de dados do parâmetro de entrada seja igual ao tipo de dados definido e que o valor do parâmetro esteja no intervalo definido.

6322

O parâmetro de entrada não corresponde ao tipo de dados floating-point de 64 bits definido no modelo TSL.

Quando o IoT Platform verifica um parâmetro com base no modelo TSL, os seguintes erros podem ocorrer:

  • O tipo de dados do parâmetro é diferente do tipo de dados definido no modelo TSL.

  • O valor do parâmetro não está no intervalo definido no modelo TSL.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL. Certifique-se de que o tipo de dados do parâmetro de entrada seja igual ao tipo de dados definido e que o valor do parâmetro esteja no intervalo definido.

6308

O parâmetro de entrada não corresponde ao tipo de dados Boolean definido no modelo TSL.

Quando o IoT Platform verifica um parâmetro com base no modelo TSL, os seguintes erros podem ocorrer:

  • O tipo de dados do parâmetro é diferente do tipo de dados definido no modelo TSL.

  • O valor do parâmetro não está no intervalo definido no modelo TSL.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL e certifique-se de que o parâmetro de entrada atenda aos requisitos do tipo de dados definido no modelo TSL.

6309

O parâmetro de entrada não corresponde ao tipo de dados ENUM definido no modelo TSL.

O tipo de dados do parâmetro é diferente do tipo de dados definido no modelo TSL.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL. Certifique-se de que o parâmetro de entrada atenda aos requisitos do tipo de dados definido.

6310

O parâmetro de entrada não corresponde ao tipo de dados text definido no modelo TSL.

Quando o IoT Platform verifica um parâmetro com base no modelo TSL, os seguintes erros podem ocorrer:

  • O tipo de dados do parâmetro é diferente do tipo de dados definido no modelo TSL.

  • O comprimento do parâmetro excede o limite definido no modelo TSL.

Acesse a página Product Details no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL. Certifique-se de que o parâmetro de entrada atenda aos requisitos do tipo de dados definido.

6311

O parâmetro de entrada não corresponde ao tipo de dados date definido no modelo TSL.

Quando o IoT Platform verifica um parâmetro com base no modelo TSL, os seguintes erros podem ocorrer:

  • O tipo de dados do parâmetro é diferente do tipo de dados definido no modelo TSL.

  • O parâmetro de data de entrada não é um timestamp UTC.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL. Certifique-se de que o parâmetro de entrada atenda aos requisitos do tipo de dados definido.

6312

O parâmetro de entrada não atende aos requisitos do tipo de dados structure definido no modelo TSL.

Quando o IoT Platform verifica um parâmetro com base no modelo TSL, os seguintes erros podem ocorrer:

  • O tipo de dados do parâmetro é diferente do tipo de dados definido no modelo TSL.

  • O número de parâmetros em uma estrutura é diferente do número de parâmetros definidos no modelo TSL.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL e certifique-se de que o parâmetro de entrada atenda aos requisitos do tipo de dados definido no modelo TSL.

6304

O parâmetro de entrada não existe na estrutura TSL.

O IoT Platform falhou ao verificar os parâmetros de entrada com base no modelo TSL porque os parâmetros de entrada não foram localizados na estrutura.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL e certifique-se de que o parâmetro de entrada exista no tipo de dados structure definido.

6324

O parâmetro de entrada não corresponde ao tipo de dados array definido no modelo TSL.

Quando o IoT Platform verifica um parâmetro com base no modelo TSL, os seguintes erros podem ocorrer:

  • Os elementos no array não estão em conformidade com a sintaxe de array definida no modelo TSL.

  • O número de elementos no array excede o número máximo definido no modelo TSL.

  • Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL e verifique a sintaxe de array definida no modelo TSL.

  • Visualize os logs de mensagens upstream para verificar o número de elementos de array nos dados enviados pelo dispositivo.

6328

O parâmetro de entrada não é um array.

O parâmetro de entrada não é um array quando o IoT Platform verifica o parâmetro com base no modelo TSL.

Acesse a página de detalhes do produto no console do IoT Platform. Na aba Define Feature, visualize o modelo TSL e verifique o parâmetro de serviço do tipo de dados array. Certifique-se de que o tipo de dados do parâmetro de entrada seja array.

6325

O tipo de dados dos elementos no array não é suportado pelo IoT Platform.

Falha ao verificar o parâmetro de entrada com base no modelo TSL porque o tipo de dados dos elementos no array não é suportado. Apenas os seguintes tipos de dados de elementos são suportados: int32, float, double, text e struct.

Certifique-se de que o tipo de dados dos elementos seja suportado pelo IoT Platform.

Códigos de erro do sistema

6318

Ocorreu uma exceção do sistema quando o IoT Platform analisou os dados TSL.

Ocorreu uma exceção do sistema.

Envie um ticket.

6329

Ocorreu um erro quando o IoT Platform analisou os dados de array no modelo TSL.

6323

O formato de dados do parâmetro no modelo TSL é inválido.

6316

Ocorreu um erro quando o IoT Platform analisou o parâmetro no modelo TSL.

6314

O tipo de dados do parâmetro no modelo TSL não é suportado.

6301

Ocorreu um erro quando o IoT Platform verificou o formato de dados dos parâmetros de entrada com base no modelo TSL.

Códigos de erro relacionados à análise de dados

26010

O throttling de tráfego foi acionado porque um número excessivo de solicitações foi enviado dentro de um período específico.

Foram enviadas solicitações excessivas dentro de um período específico.

Envie um ticket.

26001

O conteúdo do script está vazio.

O IoT Platform falhou ao obter e executar o script porque o conteúdo do script está vazio.

Acesse a página de detalhes do produto no console do IoT Platform e verifique se o script de análise de dados existe. Se existir, verifique se o script foi salvo. O script não pode ser um rascunho.

26002

Ocorreu uma exceção quando o IoT Platform executou o script.

O script executa conforme esperado, mas o conteúdo do script é inválido. Por exemplo, o script contém erros de sintaxe.

Faça login no console do IoT Platform, use os mesmos parâmetros para executar o script para depuração e modifique o script.

Importante

O console fornece um ambiente básico de execução de script, mas não verifica o script. Recomendamos que você verifique o script antes de salvá-lo no seu servidor local.

26003

Ocorreu um erro de timeout ao executar o script.

A lógica no script era muito complexa e os dados não foram analisados dentro do período de timeout de 3 segundos.

Visualize o conteúdo do script no console do IoT Platform e verifique a lógica. Certifique-se de que o script não contenha loops infinitos. Recomendamos que você verifique o script antes de salvá-lo no seu servidor local.

26006

O método necessário não existe no script.

O script executa conforme esperado, mas o conteúdo do script é inválido. O script deve conter os métodos protocolToRawData() e rawDataToProtocol(). Esse erro ocorre se um dos métodos anteriores não existir.

Acesse a página de detalhes do produto no console do IoT Platform e verifique se os métodos protocolToRawData() e rawDataToProtocol() existem.

26007

O formato dos dados retornados é inválido após a análise de dados.

O script executa conforme esperado, mas o formato dos dados retornados é inválido. O script deve conter os métodos protocolToRawData() e rawDataToProtocol(). O método protocolToRawData() retorna um array byte[]. O método rawDataToProtocol() retorna um objeto JSON. Esse erro ocorre se os dados retornados não estiverem no formato necessário. Por exemplo, depois que um dispositivo envia dados ao IoT Platform, o IoT Platform envia uma resposta ao dispositivo. Os dados retornados também devem ser analisados. Caso contrário, o formato dos dados retornados pode ser inválido.

Verifique o script no console do IoT Platform. Insira os parâmetros de entrada, execute o script no seu servidor local e verifique se o formato de dados do resultado retornado é válido.

Códigos de erro relacionados a assinatura e cancelamento de assinatura

Código de erro

Descrição

Causa

Solução de problemas

9200

O dispositivo está inativo.

O dispositivo não está ativado no console do IoT Platform. Após o registro de um novo dispositivo, ele só é ativado depois de se conectar ao IoT Platform e enviar dados ao IoT Platform.

Verifique o status do dispositivo no console do IoT Platform.

500

Ocorreu um erro interno do sistema.

Ocorreu um erro desconhecido no IoT Platform.

Envie um ticket.

403

A solicitação é proibida.

Sua conta possui pagamentos atrasados ou falha na autenticação do tópico.

Envie um ticket.

Códigos de erro relacionados a relações topológicas

Código de erro

Descrição

Causa

Solução de problemas

5005

Ocorreu um erro ao consultar as informações do produto.

O produto especificado não existe.

Faça login no console do IoT Platform e escolha Devices > Products. Na página exibida, consulte as informações do produto e verifique se o ProductKey existe.

Códigos de erro relacionados à configuração remota

Código de erro

Descrição

Causa

Solução de problemas

6710

O arquivo de configuração remota está vazio. Modifique e salve o arquivo no console do IoT Platform para obtê-lo.

O arquivo de configuração remota não foi salvo no console do IoT Platform.

Faça login no console do IoT Platform e escolha Maintenance > Remote Config. Atualize a página exibida.

Salve o conteúdo modificado na seção Configure Template.

6713

A chave de configuração remota está desligada.

A chave de configuração remota está desligada na página Remote Configuration. Essa página aparece quando você escolhe Maintenance > Remote Config no console.

No console do IoT Platform, escolha Maintenance > Remote Config. Na página exibida, verifique se o recurso de configuração remota está ativado.

Códigos de erro relacionados ao upload de arquivos

Código de erro

Descrição

Causa

Solução de problemas

78123

O arquivo a ser enviado já existe no IoT Platform.

Causas:

  • O arquivo a ser enviado tem o mesmo nome de um arquivo já enviado ao IoT Platform.

  • A política de processamento especificada para arquivos com o mesmo nome não permite que um arquivo enviado sobrescreva um arquivo existente no IoT Platform. Os dois arquivos têm o mesmo nome.

Verifique os seguintes itens:

  • Verifique se o nome do arquivo é exclusivo.

  • Verifique se a política de processamento para arquivos com o mesmo nome é overwrite.

Para mais informações, consulte a seção "Iniciar uma solicitação para enviar arquivos" em Código de exemplo.

78129

O número de arquivos que o dispositivo enviou ao IoT Platform excede o limite.

O IoT Platform pode armazenar até 1.000 arquivos enviados de cada dispositivo.

O número de arquivos que o dispositivo enviou ao IoT Platform excede 1.000.

Verifique se o número de arquivos que o dispositivo enviou ao IoT Platform excede o limite.

Códigos de erro relacionados às operações de API do IoT Platform

Para informações sobre os códigos de erro retornados ao chamar operações de API do IoT Platform, consulte Códigos de erro.