デバイスがIoT PlatformへのMQTT (Message Queuing Telemetry Transport) 接続を確立できない場合、エラーコードに基づいて問題をトラブルシューティングできます。
IoT Platformは標準のMQTTプロトコルを使用します。 MQTTプロトコルの詳細については、「MQTT 3.1または3.1.1ドキュメント」および「MQTT 5.0ドキュメント」をご参照ください。
次の表では、IoT Platformによって返されるコードについて説明します。
- MQTT 3.1および3.1.1
リターンコード Return message 説明 0 受け入れられる0x00接続 接続が確立されたときに返されるメッセージ。 1 0x01接続拒否、受け入れられないプロトコルバージョン サーバーがデバイスで使用されるMQTTプロトコルバージョンをサポートしていない場合に返されるエラーメッセージ。 2 0x02接続拒否、識別子拒否 サーバーがUTF-8エンコードされたクライアントIDをサポートしていない場合に返されるエラーメッセージ。 3 0x03接続拒否、サーバー利用できません ネットワーク接続が確立されているにもかかわらずMQTTサービスが利用できない場合に返されるエラーメッセージ。 4 0x04接続拒否、ユーザー名またはパスワードの不良 usernameまたはpasswordパラメーターの形式が無効な場合に返されるエラーメッセージ。 5 0x05接続拒否、許可されていない デバイスが認証されていない場合に返されるエラーメッセージ。 - MQTT 5.0
リターンコード Return message 説明 0 0x00の成功 接続が確立されたときに返されるメッセージ。 128 0x80不特定のエラー 未指定のエラーが発生した場合に返されるエラーメッセージ。 129 0x81不正パケット 不正なパケットを受信した場合に返されるエラーメッセージ。 130 0x82プロトコルエラー プロトコルエラーが発生した場合に返されるエラーメッセージ。 132 0x84サポートされていないプロトコルバージョン プロトコルバージョンがサポートされていない場合に返されるエラーメッセージ。 136 0x88サーバーを利用できません サーバーが使用できない場合に返されるエラーメッセージ。 137 0x89サーバービジー サーバーがビジー状態の場合に返されるエラーメッセージ。 138 0x8A禁止 アクセスが禁止されている場合に返されるエラーメッセージ。 140 0x8C不正な認証方法 認証方法が無効な場合に返されるエラーメッセージ。 141 0x8Dキープアライブタイムアウト キープアライブタイムアウトが発生した場合に返されるエラーメッセージ。 144 0x90トピック名が無効です トピック名が無効な場合に返されるエラーメッセージ。 147 0x93受信最大値を超えた 受信したメッセージの数が制限を超えた場合に返されるエラーメッセージ。 148 0x94トピックエイリアスが無効 トピックエイリアスが無効な場合に返されるエラーメッセージ。 149 0x95パケットが大きすぎる パケット長が制限を超えた場合に返されるエラーメッセージ。 150 0x96メッセージレートが高すぎる メッセージ伝送速度が高すぎる場合に返されるエラーメッセージ。 151 0x97クォータを超えました クォータを超えた場合に返されるエラーメッセージ。 152 0x98管理アクション 管理アクションのために返されたエラーメッセージ。 153 0x99ペイロード形式が無効です ペイロード形式が無効な場合に返されるエラーメッセージ。 154 0x9A保持はサポートされていません メッセージを保持できない場合に返されるエラーメッセージ。 155 0x9B QoSはサポートされません QoSがサポートされていない場合に返されるエラーメッセージ。 156 0x9C別のサーバーを使用する 別のサーバーを使用する必要がある場合に返されるエラーメッセージ。 157 0x9Dサーバー移動 サーバーが削除された場合に返されるエラーメッセージ。 158 0x9E共有サブスクリプションはサポートされていません 共有サブスクリプションがサポートされていない場合に返されるエラーメッセージ。 159 0x9F接続レートを超えた 接続レートが制限を超えた場合に返されるエラーメッセージ。