Mensagens e códigos de status do WebSocket - AWS IoT Wireless

Mensagens e códigos de status do WebSocket

Depois de criar uma solicitação pré-assinada, você pode usar o URL da solicitação com a biblioteca WebSocket ou com uma biblioteca adequada à sua linguagem de programação para fazer solicitações ao serviço. Para obter mais informações sobre como gerar essa solicitação pré-assinada, consulte Gerar uma solicitação pré-assinada com a biblioteca WebSocket.

Mensagens WebSocket

O protocolo WebSocket pode ser usado para estabelecer uma conexão bidirecional. As mensagens podem ser transmitidas de cliente para servidor e de servidor para cliente. No entanto, o analisador de rede suporta somente mensagens enviadas do servidor para o cliente. Qualquer mensagem recebida do cliente é inesperada e o servidor encerrará automaticamente a conexão do WebSocket se uma mensagem for recebida do cliente.

Quando a solicitação é recebida e uma sessão de rastreamento de mensagens é iniciada, o servidor responde com uma estrutura JSON, que é a carga útil. Para obter mais informações sobre a carga útil e como você pode ativar o rastreamento de mensagens a partir do AWS Management Console, consulte Visualize e monitore os logs de mensagens de rastreamento do analisador de rede em tempo real.

Códigos de status WebSocket

O seguinte mostra os códigos de status do WebSocket para a comunicação do servidor com o cliente. Os códigos de status do WebSocket seguem o Padrão RFC de encerramento normal de conexões.

A opção a seguir mostra os códigos de status compatíveis:

  • 1000

    Esse código de status indica um encerramento normal, ou seja, que a conexão do WebSocket foi estabelecida e a solicitação foi atendida. Esse status pode ser observado quando uma sessão está ociosa, fazendo com que a conexão atinja o tempo limite.

  • 1.002

    Esse código de status indica que o endpoint está encerrando a conexão devido a um erro de protocolo.

  • 1003

    Esse código de status indica um status de erro em que o endpoint encerrou a conexão porque recebeu dados em um formato que não pode aceitar. O endpoint suporta somente dados de texto e pode exibir esse código de status se receber uma mensagem binária ou uma mensagem do cliente que esteja usando um formato incompatível.

  • 1008

    Esse código de status indica um status de erro em que o endpoint encerrou a conexão porque recebeu uma mensagem que viola essa política. Esse status é genérico e é exibido quando os outros códigos de status, como 1003 ou 1009, não são aplicáveis. Você também verá esse status exibido se houver necessidade de ocultar a política ou quando houver uma falha na autorização, como uma assinatura expirada.

  • 1011

    Esse código de status indica um status de erro em que o servidor está encerrando a conexão porque encontrou uma condição inesperada ou um erro interno que o impediu de atender à solicitação.

Próximas etapas

Agora que você aprendeu como gerar uma solicitação pré-assinada e como observar as mensagens do servidor usando a conexão WebSocket, você pode ativar o rastreamento de mensagens e começar a receber logs de mensagens para o gateway sem fio e os recursos do dispositivo sem fio. Para ter mais informações, consulte Visualize e monitore os logs de mensagens de rastreamento do analisador de rede em tempo real.