IoT PlatformコンソールでIoT Platformログを照会できます。 IoT Platformログには、IoT Platform、デバイス、およびアプリケーション間の通信の記録が含まれます。 このトピックでは、IoT Platformログのエラーコードと、エラーのトラブルシューティングに使用できる方法について説明します。
ログのタイプ
次の図は、アップストリームメッセージのログタイプを示しています。
デバイスがIoT Platformにメッセージを送信すると、メッセージログが生成されます。 メッセージの送信に使用されるトピックがログに含まれます。
データがIoT Platformの異なるビジネスモジュールによって処理される場合、ログはビジネスモジュールによって生成されます。
データ転送機能またはサーバー側サブスクリプション機能を使用してメッセージをコンシューマーに送信すると、機能のログが生成されます。 サーバー側サブスクリプション機能を使用する場合は、メッセージを受信するようにAMQP (Advanced Message Queuing Protocol) またはMNS (Message Service) クライアントを構成できます。
次の図は、ダウンストリームメッセージのログタイプを示しています。
ユーザーがAPI操作を呼び出してメッセージを公開すると、API操作のログが生成されます。 API操作の名前はログに含まれています。
データがIoT Platformの異なるビジネスモジュールによって処理される場合、ログはビジネスモジュールによって生成されます。
メッセージがIoT Platformからデバイスに送信されると、対応するメッセージログが生成されます。 メッセージの送信に使用されるトピックがログに含まれます。
IoT Platformログの照会
IoT Platformコンソールにログインします。
[概要] ページで、[すべての環境] をクリックします。 [すべての環境] タブで、管理するインスタンスを見つけ、インスタンスIDまたはインスタンス名をクリックします。
左側のナビゲーションウィンドウで、 を選択します。 次に、[クラウド実行ログ] タブをクリックします。
製品ドロップダウンリストから製品を選択します。 検索条件を指定して [検索] をクリックします。
サポートされている検索条件を次の表に示します。
重要DeviceNameやキーワードなどの検索条件に
、'";=()[]{}?@&<>/:\n\t\r
という特殊文字が含まれている場合、検索条件の内容は複数の単語に分割されます。 この場合、クエリは失敗し、次のエラーメッセージが返されます。パラメーターは無効です。検索条件
説明
デバイス名
DeviceNameを入力します。 DeviceNameでデバイスのログを検索できます。
TraceId
相互接続されたモジュールのログを検索するトレースIDを入力します。
キーワード
キーワードを入力して、キーワードを含むログを検索します。
MessageID
メッセージIDを入力します。 メッセージIDは、メッセージ用にIoT Platformによって生成される一意の識別子です。
メッセージIDでログを検索できるのは、アップストリームとダウンストリームのメッセージを分析する場合のみです。
Status
関連ログを検索する状態を選択します。 有効な値:
すべて
成功: HTTPステータスコードが200です。
失敗: HTTPステータスコードが200されていません。
ワークロードの種類
照会するログのビジネスタイプを選択します。
時間範囲
ログを照会する時間範囲を選択します。
ログのフィールド
次の表に、ログフィールドを示します。
パラメーター | 説明 | 補足 |
時間 | ログエントリが生成された時刻。 | なし。 |
TraceId | トレースID。 トレースIDを使用して、相互接続されたモジュールを検索できます。 | なし。 |
MessageID | メッセージの ID 。 | なし。 |
デバイス名 | デバイスのDeviceName。 | なし。 |
ワークロードタイプ | デフォルトでは、すべての種類のログが表示されます。 このフィールドの値を指定して、特定の種類のログを照会できます。 次の項目では、IoT Platformログがlog Serviceにダンプされた後の、このフィールドの有効な値とLog Serviceのログフィールドとの間のマッピングについて説明します。
| ビジネスモジュールを識別する第1レベルのビジネス識別子。 |
操作 | 実行される操作、API操作名、サービスメソッド、またはメッセージトピック。 API操作名の詳細については、「関数別の操作の一覧」をご参照ください。 サービスメソッドまたはトピックの詳細については、「Alinkプロトコル」をご参照ください。 関連操作:
| 第2レベルのビジネス識別子。 |
Content | ログの内容には、次のパラメーターが含まれます。
| プロダクトのデータ形式が [カスタム] に設定されている場合、TSLデータ解析のログには、デバイスから送信された生データの16進値が含まれます。 |
Status | HTTP ステータスコード ステータスコード200は、呼び出しが成功したことを示します。 その他のステータスコードは、呼び出しが失敗したことを示します。 API操作に関連するエラーコードの詳細については、「エラーコード」をご参照ください。 その他のエラーコードの詳細については、次のセクションを参照してください。 | なし。 |
デバイスの動作に関連するエラーコード
デバイスの動作ログは、デバイスがオンラインまたはオフラインになると生成されます。
エラーコード | 説明 | 原因 | トラブルシューティング |
200 | デバイスは予想どおりオンラインまたはオフラインになります。 |
| IoT Platformコンソールの [デバイスの詳細] ページで、デバイスの [最終オンライン] パラメーターと [現在のステータス] パラメーターを表示します。 |
1910 | 指定されたタイムアウト期間中にMQTTハートビートが検出されないため、デバイスはIoT Platformから切断されます。 | IoT Platformがキープアライブ期間内にメッセージを受信しない場合、デバイスはIoT Platformから切断され、サーバーに再接続する必要があります。 MQTTハートビートの詳細については、制限の「MQTTキープアライブメカニズム」セクションを参照してください。 | MQTTハートビートがキープアライブ期間中に検出されたかどうかを確認します。 |
1911 | デバイスとIoT Platform間のTCP接続が閉じられているため、デバイスはオフラインになります。 |
| ネットワーク環境を変更するか、ファイアウォールとゲートウェイの設定を確認して問題のトラブルシューティングを行います。 たとえば、ファイアウォールを無効にすることができます。 説明 TCP接続が頻繁に中断される場合は、TCPDUMPを使用してパケットキャプチャファイルを取得し、チケットを送信できます。 |
1913 | サブデバイスが切断されています。 | ゲートウェイが切断されました。 | Log Serviceを使用してゲートウェイが切断される理由を確認します。 |
401 | デバイスには権限がありません。 | トポロジ関係を追加してサブデバイスを認証すると、サブデバイスの署名の検証に失敗します。 | Alinkプロトコルの署名メソッドを使用して、生成された署名と送信された署名を確認します。 Alinkプロトコルの詳細については、「デバイスの登録」をご参照ください。 |
427 | デバイスは例外により切断されています。 | デバイス証明書が別のデバイスで使用されているため、デバイスは強制的にオフラインになります。 IoT Platformは、デバイス証明書 (ProductKey、DeviceName、およびDeviceSecret) に基づいてのみデバイスを識別します。
|
|
520 | サブデバイスとIoT Platform間のセッションでエラーが発生しました。 |
| [デバイス] ページの [デバイスリスト] タブで、必要なデバイスを検索し、デバイスのステータスを表示します。 |
521 | デバイスが削除されます。 | デバイスがIoT Platformから削除されます。 | デバイスページの [デバイスリスト] タブで、必要なデバイスを検索して、デバイスが削除されているかどうかを確認します。 |
522 | デバイスは無効です。 | IoT Platformでデバイスが無効になっています。 | IoT Platformコンソールで、デバイスが無効状態かどうかを確認します。 |
6100 | デバイスが存在しません。 | デバイスが作成されないか、削除されます。 | デバイスページの [デバイスリスト] タブで、必要なデバイスを検索して、デバイスが存在するかどうかを確認します。 |
6204 | デバイスは無効です。 | デバイスが無効になっている場合、デバイスを管理できません。 たとえば、トポロジ関係の追加、デバイスプロパティの構成、デバイスサービスの呼び出しはできません。 | IoT Platformコンソールで、デバイスが無効状態かどうかを確認します。 |
6287 | The signature is invalid. | 直接接続されたデバイスまたはサブデバイスの署名が無効です。 | Alinkプロトコルの署名メソッドを使用して、生成された署名と送信された署名を確認します。 Alinkプロトコルの詳細については、「デバイスの登録」をご参照ください。 |
6288 | デバイスの動的登録機能が無効になっています。 | サブデバイスが属する製品の動的登録スイッチがオフになっています。 | IoT Platformコンソールで、デバイスが属するプロダクトの詳細ページで、[動的登録] スイッチをオンにします。 |
6296 | Alibaba Cloudアカウント情報がインスタンス情報と一致していません。 | インスタンスはAlibaba Cloudアカウントに属していません。 | IoT Platformコンソールで、インスタンスがAlibaba Cloudアカウントに属しているかどうかを確認します。 |
6401 | トポロジー関係は存在しません。 | トポロジー関係は存在しません。 | IoT Platformコンソールにログインし、 を選択します。 表示されるページで、デバイスを検索し、デバイス情報を表示します。 |
6402 | トポロジ関係を追加する場合、ゲートウェイはサブデバイスと同じです。 | トポロジ関係を追加する場合、ゲートウェイをサブデバイスとして自身にアタッチすることはできません。 | ゲートウェイがサブデバイスと同じかどうかを確認します。 |
6619 | サブデバイスは、別のゲートウェイに接続される。 | サブデバイスがすでにゲートウェイに接続されている場合、サブデバイスを現在のゲートウェイに接続することはできません。 | IoT Platformコンソールのデバイス詳細ページの [デバイス情報] タブで、サブデバイスが既にゲートウェイに接続されているかどうかを確認します。 |
2043 | トークンが無効なため、デバイスの認証に失敗しました。 | デバイス認証中にトークンの検証に失敗しました。 | トークンの有効期限が切れているか無効であるかを確認します。 トークンを更新または再作成できます。 |
メッセージに関連するエラーコード
メッセージ関連のログは、次のビジネスシナリオで生成されます。
デバイスはIoT Platformにメッセージを送信します。
IoT Platformはデバイスにメッセージを送信します。
ルールエンジンは、サーバー側のサブスクリプションまたはデータ転送機能を使用してメッセージを転送します。
エラーコード | 説明 | 原因 | トラブルシューティング |
1004 | デバイスがIoT Platformに送信するデータの形式が無効です。 | 次のOTA更新シナリオでは、アップストリームデータの形式が無効です。
| アップストリームデータの形式を確認してください。 データ形式の詳細については、「OTAの更新」をご参照ください。 |
1901 | TCP書き込みバッファの輻輳などのネットワーク状態が悪いため、メッセージの送信に失敗しました。 | デバイスとサーバー間のデータチャネルがブロックされています。 考えられる原因は、ネットワークの伝送速度が遅いか、デバイスが大量のメッセージを処理できないことです。 | デバイスのネットワーク状態とメッセージ消費機能を確認します。 |
1902 | メッセージがネットワーク経由で送信されたときに例外が発生しました。 | ネットワーク例外によりメッセージ送信に失敗しました。 | ネットワークの状態を確認します。 |
1903 | トピックの形式が無効です。 | メッセージトピックの形式が無効です。 | トピックの形式を確認します。 |
1904 | IoT Platformは、無効なrevert-remote procedure call (RRPC) 応答を受信しました。 | IoT Platformによって受信されたRRPC応答には、対応するRRPC要求がありません。 このエラーは、リクエストがタイムアウトすると発生する可能性があります。 | デバイスからのRRPC応答がタイムアウトしたかどうかを確認します。 |
1905 | IoT Platformは、タイムアウト期間内にRRPC応答を受信しません。 | IoT PlatformがデバイスにRRPCリクエストを送信した後、IoT Platformはタイムアウト期間内にデバイスからRRPCレスポンスを受信しませんでした。 | デバイスがタイムアウト期間内にRRPCリクエストに応答したかどうかを確認します。 |
1941 | デバイスの認証に失敗しました。 | トークンの検証に失敗しました。 | トークンを確認して再取得します。 次に、リクエストを再開します。 |
1942 | メッセージ通信は抑制される。 | 過剰なリクエストがトピックに送信されます。 | 単一のデバイスからメッセージが送信される頻度を減らすか、テクニカルサポートに連絡してください。 |
1950 | メッセージがネットワーク経由で送信されたときにネットワーク接続例外が発生しました。 | ネットワーク例外のため、メッセージの送信に失敗しました。 | ネットワークの状態を確認します。 |
1951 | 応答タイプは不明です。 | デバイスがIoT Platformに不明なタイプのメッセージを送信しました。 | デバイスから送信されるメッセージのタイプを確認します。 Alibaba Cloud Link SDKを使用している場合は、テクニカルサポートに連絡するか、チケットを起票してください。 |
6733 | ネットワーク情報に基づいてデバイスを特定できません。 | 指定されたネットワーク情報に基づいてデバイスを特定できませんでした。 | ネットワーク情報を変更し、デバイスを再配置します。 |
6736 | IPアドレスに基づいてデバイスを特定できません。 | 指定されたIPアドレスに基づいてデバイスを特定できませんでした。 | IPアドレスを変更し、デバイスを再度検索します。 |
6831 | 指定されたトピックまたはリクエストメソッドがAlinkプロトコルに準拠していません。 | デバイスがデータを送信するトピックまたは解析されたデータ内のメソッドパラメーターが、Alinkプロトコルに準拠していません。 | デバイスがデータを送信するトピックがAlinkプロトコルに準拠しているかどうかを確認します。 解析されたデータのメソッドパラメーターがAlinkプロトコルに準拠しているかどうかを確認します。 |
9200 | デバイスがアクティブではありません。 | デバイスがIoT Platformコンソールでアクティブ化されていません。 新しいデバイスが登録された後、デバイスはIoT Platformに接続され、IoT Platformにデータを送信した後にのみアクティブ化されます。 | IoT Platform コンソールでデバイスのステータスを確認してください。 |
9201 |
|
|
|
9203 | サーバー側のサブスクリプションはオフラインです。 | メッセージがサーバー側サブスクリプションに転送されると、サーバー側サブスクリプションに関連付けられているAMQPクライアントまたはMNSクライアントはオフラインになります。 | サーバー側サブスクリプションに関連付けられているAMQPクライアントまたはMNSクライアントがオンラインであることを確認します。 |
9236 | トピックの認証に失敗しました。 | トピックに対して付与されている権限が無効です。 | IoT Platformでデバイスが属する製品の詳細ページの [トピックカテゴリ] タブに移動します。 トピックが属するトピックカテゴリの [許可された操作] 列の権限が有効かどうかを確認します。
|
9307 | SQL文の解析に失敗しました。 | SQL文またはパラメーターの構文が不正です。 | SQL文の構文とパラメーターを確認してください。 |
9324 | スロットルエラーが発生しました。 | デバイスまたはテナントからのリクエスト数が制限を超えました。 説明 スロットリングの詳細については、「制限」の「データ転送」セクションをご参照ください。 | メッセージの送信頻度を減らすか、テクニカルサポートに連絡してください。 |
9325 | データのクラウドサービスへの転送に失敗しました。 | 移行先のクラウドサービスが利用できません。 | 移行先のクラウドサービスが利用可能かどうかを確認します。 支払いの滞納、インスタンスの削除、またはIoT Platformがクラウドサービスへのアクセスに使用する権限が削除された場合、クラウドサービスは利用できなくなります。 |
9321 | パラメーターが無効です。 | 入力パラメーターが無効です。 | プロンプトに従ってパラメータを確認します。 |
9320 | ペイロードが無効です。 | デバイスが送信するペイロードの形式が無効です。 | ペイロードの形式が有効かどうかを確認します。 |
9331 | 移行先のクラウドサービスで内部エラーが発生しました。 | メッセージの送信先のクラウドサービスで内部エラーが発生しました。 | ログエントリのエラーコードを確認し、対応するクラウドサービスの公式Webサイトにアクセスして、エラーの原因と解決策を確認します。 テクニカルサポートに連絡することもできます。 |
9332 | クラウドサービスの設定が無効です。 | 指定されたデータ転送先は無効です。 IoT Platformが移行先のクラウドサービスに接続中にエラーが発生しました。 | データ転送ルールを表示して、移行先クラウドサービスの設定が有効かどうか、およびリソースが存在するかどうかを確認します。 ログエントリのエラーコードを確認し、クラウドサービスの公式Webサイトにアクセスして、エラーの原因と解決策を確認してください。 |
9362 | スクリプトの実行時に例外が発生しました。 | ルールエンジンがスクリプトを実行したときに解析例外が発生しました。 考えられる原因:
ログの内容に基づいて、エラーの原因を特定できます。 | ログの内容に基づいて、スクリプト構文と関数呼び出しを確認します。 |
9333 | クラウドサービスへのアクセス権限が無効です。 | IoT Platformに付与された移行先クラウドサービスへのアクセス権限が無効です。 | Alibaba Cloud Resource Access Management (RAM) ポリシーを確認します。 |
9389 | ゲートウェイがオフラインのため、サブデバイスはメッセージを送信できませんでした。 | サブデバイスが接続されているゲートウェイはオフラインです。 | [デバイス] ページの [デバイスリスト] タブで、必要なゲートウェイを検索し、ゲートウェイのステータスを表示します。 ゲートウェイがオンラインであることを確認するか、ゲートウェイを再起動してサブデバイスをIoT Platformに接続します。 |
9399 | 不明な内部サーバーエラーが発生しました。 | IoT Platformで内部エラーが発生しました。 | テクニカルサポートに連絡するか、チケットを起票してください。 |
9600 | コンシューマグループ内の接続数が制限を超えています。 | IoT Platformは多数の接続を処理できません。 詳細については、「サーバー側サブスクリプションの制限」をご参照ください。 | 不要な接続を閉じます。 |
9601 | ハートビート値が無効です。 | ハートビート値が要件を満たしていません。 詳細については、「サーバー側サブスクリプションの制限」をご参照ください。 | 有効なハートビート値を指定します。 |
9602 | IoT Platformは接続を閉じます。 | このエラーは、負荷分散およびIoT Platformの反復シナリオで発生する可能性があります。 デバイスはIoT Platformに再接続できる必要があります。 この問題はビジネスの継続性には影響しません。 | チケットを起票してください。 |
9650 | ACKメッセージがタイムアウトします。 | タイムアウト期間内に受信機から応答は送信されない。 したがって、受信機からのACKメッセージはタイムアウトした。 | 受信者のメッセージ処理ロジックを確認します。 |
9651 | 受信機はACK解除を返す。 | 受信機はACK解除を返す。 | |
9652 | 受信機はNACKを返す。 | 受信機はNACKを返す。 |
TSLモデルに関連するエラーコード
TSLモデルに関連するログは、次のビジネスシナリオで生成されます。
デバイスはTSLデータを送信します。
IoT PlatformはTSLサービスを呼び出します。
プロダクトのデータ形式が [カスタム] に設定されている場合、TSL関連のログには、デバイスから送信された生データの16進値が含まれます。
次の表に、IoT Platformがサービスを呼び出してプロパティを設定するときに返されるエラーコードを示します。
IoT Platformがサービスを呼び出すと、IoT Platformは、サービスの入力パラメーターがTSLモデルで定義されている構文に従っているかどうかを確認します。
エラーコード | 説明 | 原因 | トラブルシューティング | |
一般的なエラーコード | 100000 | パラメーターが無効です。 | IoT PlatformのパブリックインスタンスまたはEnterprise Editionインスタンスのプロダクトに関する設定情報を照会すると、インスタンスIDの取得に失敗しました。 | IoT Platformインスタンスにアクセスしたかどうかを確認します。 IoT Platformインスタンスにアクセスした場合は、トラブルシューティングのチケットを起票してください。 |
9201 | コンシューマーグループはオフラインです。 | サーバー側サブスクリプションに関連付けられているコンシューマーグループはオフラインです。 | IoT Platformコンソールに移動し、 を選択し、[コンシューマーグループ] をクリックします。 [コンシューマーグループ] タブで、[コンシューマーグループのステータス] を表示します。 [消費ログ] タブで、コンシューマーグループがIoT Platformに接続および切断された理由を表示します。 | |
9200 | デバイスは起動していません。 | デバイスがIoT Platformコンソールでアクティブ化されていません。 新しく登録されたデバイスは、デバイスがIoT Platformにデータを送信した後にのみアクティブ化されます。 | IoT Platform コンソールでデバイスのステータスを確認してください。 | |
9237 | IoT Platformサービスに料金滞納が存在します。 | Alibaba Cloudアカウントに料金滞納があります。 | IoT Platformコンソールの右上隅にある [費用] をクリックし、ユーザーセンターでアカウントの残高を表示します。 アカウントの残高が十分であることをご確認ください。 それ以外の場合、IoT Platformデバイスは利用できません。 | |
9389 | ゲートウェイがオフラインのため、サブデバイスはメッセージを送信できませんでした。 | サブデバイスが接続されているゲートウェイはオフラインです。 | [デバイス] ページの [デバイスリスト] タブで、必要なゲートウェイを検索し、ゲートウェイのステータスを表示します。 ゲートウェイがオンラインであることを確認するか、ゲートウェイを再起動してサブデバイスをIoT Platformに接続します。 | |
6208 | デバイスは無効です。 | デバイスを無効にすると、IoT Platformはデバイスプロパティを設定したり、デバイスサービスを呼び出したりできません。 | IoT Platform コンソールでデバイスのステータスを確認してください。 デバイスが無効になっている場合は、デバイスを有効にしてから再試行してください。 | |
6300 | IoT PlatformがTSLモデルに基づいて入力パラメーターを検証する場合、methodパラメーターは存在しません。 | Alinkプロトコルで必要なメソッドパラメーターは、入力パラメーターに存在しません。 入力パラメーターは、デバイスから送信された標準Alinkデータ、またはデバイスから送信されたカスタムデータの解析結果です。 | デバイスプロパティレポートに関するIoT Platformログを表示し、デバイスによって送信されたデータを確認します。 オンプレミスデバイスログを表示して、送信されたデータを確認することもできます。 | |
6206 | サービスを照会したときにエラーが発生しました。 | IoT Platformがサービスを呼び出すと、サービスに関する情報が照会されます。 このエラーは、サービスが存在しない場合に発生します。 | IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、サービスがTSLモデルで定義されているかどうかを確認します。 サービスが定義されている場合は、サービスの入力パラメーターに不可視文字が含まれているかどうかを確認します。 | |
6200 | スクリプトは存在しません。 | プロダクトのデータ形式がカスタムに設定されている場合、IoT Platformがデバイスのサービスを呼び出すときにスクリプトを使用してデータを解析します。 このエラーは、データ解析スクリプトを定義しない場合に発生します。 | IoT Platformコンソールの製品詳細ページに移動します。 データ解析スクリプトが存在するかどうかを確認します。 データ解析スクリプトが存在する場合は、スクリプトを再送信してから再試行してください。 | |
6201 | 解析結果が空です。 | データ解析スクリプトは期待どおりに実行されますが、空の結果が返されます。 たとえば、rawDataToProtocol() メソッドはnullを返し、protocolToRawData() メソッドはnullまたは空の配列を返します。 | スクリプトでエラーの原因を确认してください。 | |
6207 | データ形式が無効です。 | このエラーは、IoT Platformがサービスを同期的に呼び出すとき、またはデバイスがデータを送信するときに発生する可能性があります。 IoT Platformがサービスを同期的に呼び出す場合、次のいずれかの理由でこのエラーが発生する可能性があります。
| サービスに必要な有効なデータ形式の詳細については、「APIドキュメント」と「TSL定義」をご参照ください。 Alinkプロトコルで必要なデータ形式については、「Alinkプロトコル」をご参照ください。 | |
6330 | データ形式が、Long型の定義された形式に準拠していません。 | Long型のパラメータまたはプロパティは、TSLモデルで定義されています。 メッセージのデータ形式が、Long型の定義された形式に準拠していません。 |
| |
6335 | デバイスがプロパティ構成要求への応答として送信するメッセージのパラメーターが空ではありません。 | デバイスがIoT Platformから送信されたプロパティ設定要求に応答する場合、dataフィールドで示される応答データは空である必要があります。 |
| |
6336 | TSLモデルの時間パラメーターの値が無効です。 | デバイスがTSLプロパティまたはTSLイベントのデータを送信すると、データのtimeパラメーターの値が要件を満たしていません。 重要 デバイスは、TSLプロパティとTSLイベントのデータを24時間以内に送信できます。 | TSLプロパティまたはTSLイベントの送信データのtimeパラメーターの値がすべての要件を満たしているかどうかを確認します。 | |
5490 | 指定されたTSLモジュールは存在しません。 | 指定されたカスタムTSLモジュールは存在しません。 |
| |
5092 | このプロパティはTSLモデルに存在しません。 | アップストリームまたはダウンストリームメッセージのプロパティは、TSLモデルで定義されていません。 重要 カスタムTSLモジュールで定義されているプロパティの場合、 |
| |
5094 | サービスはTSLモデルに存在しません。 | サービスがTSLモデルで定義されていないか、サービスパラメーターが無効です。 重要 カスタムTSLモジュールで定義されているサービスの場合、サービスを |
| |
5096 | イベントはTSLモデルに存在しません。 | イベントがTSLモデルで定義されていないか、イベントパラメーターが無効です。 重要 カスタムTSLモジュールで定義されているイベントの場合、 |
| |
システムエラーコード | 5159 | IoT PlatformがTSLプロパティデータを取得したときにエラーが発生しました。 | システムの例外が発生しました。 | チケットを起票してください。 |
5160 | IoT PlatformがTSLイベントデータを取得したときにエラーが発生しました。 | |||
5161 | IoT PlatformがTSLサービスデータを取得したときにエラーが発生しました。 | |||
6661 | IoT Platformがテナント情報を照会したときにエラーが発生しました。 | |||
6205 | IoT Platformがサービスを呼び出したときにエラーが発生しました。 | |||
26015 | IoT Platformがデータを解析するスクリプトを実行したときにエラーが発生しました。 |
次の表に、デバイスがプロパティおよびイベントデータを送信できなかった場合に生成されるエラーコードを示します。
デバイスがプロパティまたはイベントデータを送信すると、IoT PlatformはTSLモデルに基づいてイベントのプロパティデータまたは入力パラメーターを検証します。
エラーコード | 説明 | 原因 | トラブルシューティング | |
一般的なエラーコード | 6106 | デバイスによって送信されたプロパティの数が制限を超えています。 | デバイスは、一度に最大200のプロパティを送信できます。 | デバイスプロパティレポートに関するIoT Platformログを表示し、デバイスによって送信されたプロパティの数を確認します。 オンプレミスデバイスログを表示して、送信されたデータを確認することもできます。 |
6300 | IoT PlatformがTSLモデルに基づいて入力パラメーターを検証する場合、methodパラメーターは存在しません。 | Alinkプロトコルで必要なメソッドパラメーターは、入力パラメーターに存在しません。 入力パラメーターは、デバイスから送信された標準Alinkデータ、またはデバイスから送信されたカスタムデータの解析結果です。 | デバイスプロパティレポートに関するIoT Platformログを表示し、デバイスによって送信されたデータを確認します。 オンプレミスのデバイスログを表示し、送信されたデータを確認することもできます。 | |
6320 | IoT PlatformがTSLモデルに基づいて入力パラメーターを検証する場合、プロパティ情報は存在しません。 | システムがデバイスのTSLデータを照会したときに、指定されたプロパティが見つかりませんでした。 | IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、指定したプロパティがTSLモデルで定義されているかどうかを確認します。 プロパティが定義されていない場合は、プロパティを定義します。 | |
6367 | デバイスがTSLプロパティまたはTSLイベントのデータを送信すると、データのtimeパラメーターの値が要件を満たしていません。 | デバイスがTSLプロパティまたはTSLイベントのデータを送信する場合、過去30日間のデータのみを送信できます。 | TSLプロパティまたはTSLイベントの送信データのtimeパラメーターの値がすべての要件を満たしているかどうかを確認します。 | |
6450 | メソッドパラメーターはAlinkデータに存在しません。 | メソッドパラメーターは、標準Alinkデータに存在しません。 標準Alinkデータは、デバイスによって直接送信することも、デバイスによって送信されたカスタムデータから変換することもできます。 | デバイスプロパティレポートに関するIoT Platformログを表示し、送信されたデータにmethodパラメーターが含まれているかどうかを確認します。 オンプレミスのデバイスログを表示することもできます。 | |
6207 | データ形式が無効です。 | このエラーは、IoT Platformがサービスを同期的に呼び出すとき、またはデバイスがデータを送信するときに発生する可能性があります。 デバイスがデータを送信すると、デバイスによって送信されたAlinkデータまたはスクリプトを使用して解析されたデータがJSON形式でないため、このエラーが発生する可能性があります。 | Alinkプロトコルに必要なデータ形式の詳細については、「Alinkプロトコル」をご参照ください。 データを送信するには、必要なデータ形式を使用する必要があります。 | |
システムエラーコード | 6452 | スロットルエラーが発生しました。 | 過剰な数のリクエストが送信されるため、トラフィックスロットリングがトリガーされます。 | チケットを起票してください。 |
6760 | テナントのストレージクォータを超えています。 | システムの例外が発生しました。 | チケットを起票してください。 |
次の表に、デバイスがIoT Platformからのサービス呼び出しおよびプロパティ設定要求に応答しなかった場合に返されるエラーコードを示します。
エラーコード | 説明 | 原因 | トラブルシューティング | |
一般的なエラーコード | 460 | パラメーターが無効です。 | リクエストパラメーターは無効です。 | チケットを起票してください。 |
500 | 内部システムエラーが発生しました。 | IoT Platformで不明なエラーが発生しました。 | チケットを起票してください。 | |
400 | リクエストエラーが発生しました。 | IoT Platformがサービスを呼び出したときに不明なエラーが発生しました。 | チケットを起票してください。 | |
429 | 特定の期間内に過剰な数のリクエストが送信されました。 | 特定の期間内に過剰な数のリクエストが送信されるため、トラフィックスロットリングがトリガーされます。 | チケットを起票してください。 | |
システムエラーコード | 6452 | スロットルエラーが発生しました。 | 過剰な数のリクエストが送信されるため、トラフィックスロットリングがトリガーされます。 | チケットを起票してください。 |
次の表に、TSLモデルに関連する一般的なエラーコードを示します。
IoT Platformは、TSLモデルに基づいて、サービスの入力パラメーター、プロパティデータ、およびイベントの入力パラメーターを検証します。
エラーコード | 説明 | 原因 | トラブルシューティング | |
一般的なエラーコード | 6321 | プロパティの識別子がTSLモデルに存在しません。 | システムの例外が発生しました。 | チケットを起票してください。 |
6317 | TSLモデルが無効です。 | システムの例外が発生しました。 | チケットを起票してください。 | |
6332 | 入力パラメーターがTSL定義に準拠していません。 | 入力パラメーターはTSL定義に準拠している必要があります。 | IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブでTSLモデルを表示します。 入力パラメータを確認します。 | |
6302 | パラメーターが存在しません。 | IoT Platformは、リクエストにパラメーターが含まれていなかったため、TSLモデルに基づいてサービスの入力パラメーターを検証できませんでした。 | IoT Platformコンソールの [製品の詳細] ページに移動します。 [機能の定義] タブでTSLモデルを表示します。 TSLモデルのサービスの入力パラメーターを確認し、必要なパラメーターがすべて設定されていることを確認します。 | |
6306 | 入力パラメーターが、TSLモデルで定義されている整数データ型と一致しません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。
| IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、入力パラメーターがTSLモデルで定義されているデータ型の要件を満たしていることを確認します。 | |
6307 | 入力パラメーターが、TSLモデルで定義されている32ビットの浮動小数点データ型と一致しません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。
| IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターのデータ型が定義されたデータ型と同じであり、パラメーター値が定義された範囲内にあることを確認してください。 | |
6322 | 入力パラメーターが、TSLモデルで定義されている64ビット浮動小数点データ型と一致しません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。
| IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターのデータ型が定義されたデータ型と同じであり、パラメーター値が定義された範囲内にあることを確認してください。 | |
6308 | 入力パラメーターが、TSLモデルで定義されているブール型のデータ型と一致しません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。
| IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、入力パラメーターがTSLモデルで定義されているデータ型の要件を満たしていることを確認します。 | |
6309 | 入力パラメーターが、TSLモデルで定義されているENUMデータ型と一致しません。 | パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。 | IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターが定義されたデータ型の要件を満たしていることを確認します。 | |
6310 | 入力パラメーターが、TSLモデルで定義されているテキストデータ型と一致しません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。
| IoT Platformコンソールの [製品の詳細] ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターが定義されたデータ型の要件を満たしていることを確認します。 | |
6311 | 入力パラメーターが、TSLモデルで定義されている日付データ型と一致しません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。
| IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターが定義されたデータ型の要件を満たしていることを確認します。 | |
6312 | 入力パラメーターは、TSLモデルで定義されている構造体データ型の要件を満たしていません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。
| IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、入力パラメーターがTSLモデルで定義されているデータ型の要件を満たしていることを確認します。 | |
6304 | 入力パラメーターがTSL構造に存在しません。 | IoT Platformは、入力パラメータが構造内に配置されなかったため、TSLモデルに基づいて入力パラメータを検証できませんでした。 | IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、入力パラメーターが定義された構造データ型に存在することを確認します。 | |
6324 | 入力パラメーターが、TSLモデルで定義されている配列データ型と一致しません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。
|
| |
6328 | 入力パラメーターは配列ではありません。 | IoT PlatformがTSLモデルに基づいてパラメーターを検証する場合、入力パラメーターは配列ではありません。 | IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、配列データ型のサービスパラメーターを確認します。 入力パラメーターのデータ型が配列であることを確認してください。 | |
6325 | 配列内の要素のデータ型は、IoT Platformではサポートされていません。 | 配列内の要素のデータ型がサポートされていないため、TSLモデルに基づいて入力パラメーターを検証できませんでした。 サポートされている要素のデータ型は、int32、float、double、text、structだけです。 | 要素のデータ型がIoT Platformでサポートされていることを確認してください。 | |
システムエラーコード | 6318 | IoT PlatformがTSLデータを解析したときにシステム例外が発生しました。 | システムの例外が発生しました。 | チケットを起票してください。 |
6329 | IoT PlatformがTSLモデルの配列データを解析したときにエラーが発生しました。 | |||
6323 | TSLモデルのパラメーターのデータ形式が無効です。 | |||
6316 | IoT PlatformがTSLモデルのパラメーターを解析したときにエラーが発生しました。 | |||
6314 | TSLモデルのパラメーターのデータ型はサポートされていません。 | |||
6301 | IoT PlatformがTSLモデルに基づいて入力パラメーターのデータ形式を検証したときにエラーが発生しました。 | |||
データ解析に関連するエラーコード | 26010 | 特定の期間内に過剰な数のリクエストが送信されるため、トラフィックスロットリングがトリガーされます。 | 特定の期間内に過剰なリクエストが送信されました。 | チケットを起票してください。 |
26001 | スクリプトの内容は空です。 | スクリプトのコンテンツが空のため、IoT Platformはスクリプトの取得と実行に失敗しました。 | IoT Platformコンソールの製品詳細ページに移動し、データ解析スクリプトが存在するかどうかを確認します。 スクリプトが存在する場合は、スクリプトが保存されているかどうかを確認します。 スクリプトをドラフトにすることはできません。 | |
26002 | IoT Platformがスクリプトを実行したときに例外が発生しました。 | スクリプトは期待どおりに実行されますが、スクリプトの内容は無効です。 たとえば、スクリプトには構文エラーが含まれています。 | IoT Platformコンソールにログインし、同じパラメーターを使用してデバッグ用のスクリプトを実行し、スクリプトを変更します。 重要 コンソールは基本的なスクリプト実行環境を提供しますが、スクリプトの検証は行いません。 オンプレミスサーバーにスクリプトを保存する前に、スクリプトを確認することをお勧めします。 | |
26003 | スクリプトの実行時にタイムアウトエラーが発生しました。 | スクリプトのロジックが複雑すぎて、3秒のタイムアウト期間内にデータを解析できませんでした。 | IoT Platformコンソールでスクリプトの内容を表示し、ロジックを確認します。 スクリプトに無限ループが含まれていないことを確認してください。 オンプレミスサーバーにスクリプトを保存する前に、スクリプトを確認することをお勧めします。 | |
26006 | 必要なメソッドがスクリプトに存在しません。 | スクリプトは期待どおりに実行されますが、スクリプトの内容は無効です。 スクリプトには、protocolToRawData() メソッドとrawDataToProtocol() メソッドが含まれている必要があります。 このエラーは、上記の方法のいずれかが存在しない場合に発生します。 | IoT Platformコンソールの製品詳細ページに移動し、protocolToRawData() メソッドとrawDataToProtocol() メソッドが存在するかどうかを確認します。 | |
26007 | データ解析の実行後、返されるデータ形式は無効です。 | スクリプトは期待どおりに実行されますが、返されるデータの形式は無効です。 スクリプトには、protocolToRawData() メソッドとrawDataToProtocol() メソッドが含まれている必要があります。 protocolToRawData() メソッドは、byte[] 配列を返します。 rawDataToProtocol() メソッドはJSONオブジェクトを返します。 このエラーは、返されたデータが必要な形式でない場合に発生します。 たとえば、デバイスがIoT Platformにデータを送信した後、IoT Platformはデバイスに応答を送信します。 返されたデータも解析する必要があります。 そうしないと、返されるデータの形式が無効になる可能性があります。 | IoT Platformコンソールでスクリプトを確認します。 入力パラメーターを入力し、オンプレミスサーバーでスクリプトを実行し、返された結果のデータ形式が有効かどうかを確認します。 |
サブスクリプションおよびサブスクリプション解除に関連するエラーコード
エラーコード | 説明 | 原因 | トラブルシューティング |
9200 | デバイスがアクティブではありません。 | デバイスがIoT Platformコンソールでアクティブ化されていません。 新しいデバイスが登録された後、デバイスはIoT Platformに接続され、IoT Platformにデータを送信した後にのみアクティブ化されます。 | IoT Platform コンソールでデバイスのステータスを確認してください。 |
500 | 内部システムエラーが発生しました。 | IoT Platformで不明なエラーが発生しました。 | チケットを起票してください。 |
403 | リクエストは禁止されています。 | アカウントに料金滞納があるか、トピックの認証に失敗しました。 | チケットを起票してください。 |
トポロジ関係に関連するエラーコード
エラーコード | 説明 | 原因 | トラブルシューティング |
5005 | 製品情報を照会したときにエラーが発生しました。 | 指定されたプロダクトは存在しません。 | IoT Platformコンソールにログインし、 を選択します。 表示されるページで、製品情報を照会し、ProductKeyが存在するかどうかを確認します。 |
リモート設定に関連するエラーコード
エラーコード | 説明 | 原因 | トラブルシューティング |
6710 | リモート設定ファイルが空です。 ファイルを取得するには、IoT Platformコンソールでファイルを変更して保存する必要があります。 | リモート設定ファイルはIoT Platformコンソールに保存されません。 | IoT Platformコンソールにログインし、 を選択します。表示されるページを更新します。変更したコンテンツを [テンプレートの設定] セクションに保存します。 |
6713 | リモート設定スイッチがオフになります。 | [リモート設定] ページで、リモート設定スイッチがオフになっています。 このページは、コンソールで を選択すると表示されます。 | IoT Platformコンソールで、 を選択します。表示されるページで、リモート設定機能が有効になっているかどうかを確認します。 |
ファイルのアップロードに関連するエラーコード
エラーコード | 説明 | 原因 | トラブルシューティング |
78123 | アップロードするファイルは既にIoT Platformに存在します。 | 原因:
| 次の項目を確認してください。
詳細については、サンプルコードの「ファイルのアップロード要求の開始」をご参照ください。 |
78129 | デバイスがIoT Platformにアップロードしたファイルの数が制限を超えています。 IoT Platformは、各デバイスからアップロードされる最大1,000個のファイルを保存できます。 | デバイスがIoT Platformにアップロードしたファイルの数が1,000を超えています。 | デバイスがIoT Platformにアップロードしたファイルの数が制限を超えていないか確認します。 |
IoT Platform API操作に関連するエラーコード
IoT Platform API操作を呼び出したときに返されるエラーコードの詳細については、「エラーコード」をご参照ください。