Messages et codes d’état WebSocket - AWS IoT Wireless

Messages et codes d’état WebSocket

Après avoir créé une demande présignée, vous pouvez utiliser l’URL de la demande avec votre bibliothèque WebSocket, ou une bibliothèque adaptée à votre langage de programmation, pour envoyer des demandes au service. Pour en savoir plus sur la génération de cette demande présignée, consultez Générer une demande présignée avec la bibliothèque WebSocket.

Messages WebSocket

Le protocole WebSocket peut être utilisé pour établir une connexion bidirectionnelle. Les messages peuvent être transmis d’un client à un serveur et d’un serveur à un autre. Toutefois, l’analyseur de réseau ne prend en charge que les messages envoyés du serveur au client. Tout message reçu du client est inattendu et le serveur ferme automatiquement la connexion WebSocket si un message est reçu du client.

Lorsque la demande est reçue et qu’une session de messagerie de suivi démarre, le serveur répond avec une structure JSON, qui est la charge utile. Pour plus d’informations sur la charge utile et sur la manière dont vous pouvez activer la messagerie de suivi depuis le AWS Management Console, consultezAfficher et suivre les journaux des messages de suivi de l’analyseur de réseau en temps réel.

Codes d’état WebSocket

Ce qui suit montre les codes d’état WebSocket pour la communication entre le serveur et le client. Les codes d’état WebSocket sont conformes à la norme RFC relative à la fermeture normale des connexions.

Voici la liste des codes d’état pris en charge :

  • 1 000

    Ce code d’état indique une fermeture normale, ce qui signifie que la connexion WebSocket a été établie et que la demande a été satisfaite. Cet état peut être observé lorsqu’une session est inactive, ce qui entraîne l’expiration de la connexion.

  • 1 002

    Ce code d’état indique que le point de terminaison met fin à la connexion en raison d’une erreur de protocole.

  • 1003

    Ce code d’état indique un état d’erreur lorsque le point de terminaison a mis fin à la connexion parce qu’il a reçu des données dans un format qu’il ne peut pas accepter. Le point de terminaison ne prend en charge que les données texte et peut afficher ce code d’état s’il reçoit un message binaire ou un message du client utilisant un format non pris en charge.

  • 1008

    Ce code d’état indique un état d’erreur lorsque le point de terminaison a mis fin à la connexion parce qu’il a reçu un message enfreignant sa politique. Ce statut est générique et s’affiche lorsque les autres codes d’état, tels que 1003 ou 1009, ne sont pas applicables. Vous verrez également ce statut s’afficher s’il est nécessaire de masquer la politique ou en cas d’échec d’autorisation, tel qu’une signature expirée.

  • 1011

    Ce code d’état indique un état d’erreur lorsque le serveur met fin à la connexion parce qu’il a rencontré une situation inattendue ou une erreur interne qui l’a empêché de répondre à la demande.

Étapes suivantes

Maintenant que vous avez appris à générer une demande présignée et à observer les messages provenant du serveur à l’aide de la connexion WebSocket, vous pouvez activer la messagerie de suivi et commencer à recevoir des journaux de messages pour les ressources de votre passerelle et de votre appareil sans fil. Pour en savoir plus, consultez Afficher et suivre les journaux des messages de suivi de l’analyseur de réseau en temps réel.