このトピックの MQTT エラーコードを使用して、IoT Platform でのデバイス接続の失敗を診断して解決できます。
IoT Platform は標準の MQTT プロトコルを使用します。詳細については、「MQTT 3.1 および 3.1.1 仕様」および「MQTT 5.0 仕様」をご参照ください。
次の表に、MQTT 接続のサーバー側リターンコードを示します。
- MQTT 3.1 および 3.1.1
リターンコード リターンメッセージ 原因 0 0x00 Connection Accepted 接続に成功しました。 1 0x01 Connection Refused, unacceptable protocol version サーバーはデバイスが要求した MQTT プロトコルバージョンをサポートしていません。 2 0x02 Connection Refused, identifier rejected clientId パラメーターが無効か、IoT Platform で指定されている形式に準拠していません。たとえば、値が長さ制限を超えている、または拡張パラメーターの形式が正しくありません。 3 0x03 Connection Refused, Server unavailable ネットワーク接続は確立されていますが、MQTT サービスを利用できません。 4 0x04 Connection Refused, bad user name or password username または password パラメーターが無効です。 5 0x05 Connection Refused, not authorized デバイスが承認されていません。 - MQTT 5.0
リターンコード リターンメッセージ 原因 0 0x00 Success 接続に成功しました。 128 0x80 Unspecified error 未指定のエラーが発生しました。 129 0x81 Malformed Packet 不正な形式のパケットを受信しました。 130 0x82 Protocol Error プロトコルエラーが発生しました。 132 0x84 Unsupported Protocol Version プロトコルバージョンがサポートされていません。 136 0x88 Server unavailable サーバーを利用できません。 137 0x89 Server busy サーバーがビジー状態です。 138 0x8A Banned アクセスが禁止されています。 140 0x8C Bad authentication method 認証方法が無効です。 141 0x8D Keep Alive timeout キープアライブタイムアウトが発生しました。 144 0x90 Topic Name invalid トピック名が無効です。 147 0x93 Receive Maximum exceeded 受信メッセージの最大数を超えています。 148 0x94 Topic Alias invalid トピックエイリアスが無効です。 149 0x95 Packet too large パケット長が上限を超えています。 150 0x96 Message rate too high メッセージ送信レートが高すぎます。 151 0x97 Quota exceeded クォータを超過しています。 152 0x98 Administrative action 管理上の措置が行われました。 153 0x99 Payload format invalid ペイロード形式が無効です。 154 0x9A Retain not supported メッセージ保持はサポートされていません。 155 0x9B QoS not supported サービス品質 (QoS) レベルがサポートされていません。 156 0x9C Use another server 別のサーバーを使用してください。 157 0x9D Server moved サーバーが移動されました。 158 0x9E Shared Subscription not supported 共有サブスクリプションはサポートされていません。 159 0x9F Connection rate exceeded 接続レートを超過しています。