すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:IoT Platformログ

最終更新日:Feb 06, 2024

IoT PlatformコンソールでIoT Platformログを照会できます。 IoT Platformログには、IoT Platform、デバイス、およびアプリケーション間の通信の記録が含まれます。 このトピックでは、IoT Platformログのエラーコードと、エラーのトラブルシューティングに使用できる方法について説明します。

ログのタイプ

次の図は、アップストリームメッセージのログタイプを示しています。

上行消息日志

  1. デバイスがIoT Platformにメッセージを送信すると、メッセージログが生成されます。 メッセージの送信に使用されるトピックがログに含まれます。

  2. データがIoT Platformの異なるビジネスモジュールによって処理される場合、ログはビジネスモジュールによって生成されます。

  3. データ転送機能またはサーバー側サブスクリプション機能を使用してメッセージをコンシューマーに送信すると、機能のログが生成されます。 サーバー側サブスクリプション機能を使用する場合は、メッセージを受信するようにAMQP (Advanced Message Queuing Protocol) またはMNS (Message Service) クライアントを構成できます。

次の図は、ダウンストリームメッセージのログタイプを示しています。

下行消息日志

  1. ユーザーがAPI操作を呼び出してメッセージを公開すると、API操作のログが生成されます。 API操作の名前はログに含まれています。

  2. データがIoT Platformの異なるビジネスモジュールによって処理される場合、ログはビジネスモジュールによって生成されます。

  3. メッセージがIoT Platformからデバイスに送信されると、対応するメッセージログが生成されます。 メッセージの送信に使用されるトピックがログに含まれます。

IoT Platformログの照会

  1. IoT Platformコンソールログインします。

  2. [概要] ページで、[すべての環境] をクリックします。 [すべての環境] タブで、管理するインスタンスを見つけ、インスタンスIDまたはインスタンス名をクリックします。

  3. 左側のナビゲーションウィンドウで、[メンテナンス] > [デバイスログ] を選択します。 次に、[クラウド実行ログ] タブをクリックします。

  4. 製品ドロップダウンリストから製品を選択します。 検索条件を指定して [検索] をクリックします。

    サポートされている検索条件を次の表に示します。

    重要

    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のログフィールドとの間のマッピングについて説明します。

  • OTAアップデート: OTA

  • データ解析: ScriptParsing

  • TSL for Thing Specification Language (TSL) データ検証、TSLサービスコール、およびTSLメッセージ: ThingModel

  • 時系列データストレージ: HotDataStorage

  • リモート設定: RemoteConfig

  • トポロジ関係: ThingTopo

  • デバイスの動作: Device

  • デバイスからクラウドへのメッセージ: uplink

  • クラウドからデバイスへのメッセージ: downlink

  • APIコール: ApiService

  • サーバー側サブスクリプション: ServiceSubscribe

  • デバイスシャドウ: DeviceShadow

  • ルールエンジン: RuleEngine

  • サブスクリプション: subscribe

  • 購読解除: 購読解除

  • Thing Job: DeviceFileUpload

  • その他: その他

ビジネスモジュールを識別する第1レベルのビジネス識別子。

操作

実行される操作、API操作名、サービスメソッド、またはメッセージトピック。

API操作名の詳細については、「関数別の操作の一覧」をご参照ください。 サービスメソッドまたはトピックの詳細については、「Alinkプロトコル」をご参照ください。

関連操作:

  • OTAアップデート

    • OTAFirmwarePush: ファームウェアの更新が開始、確認、完了したときに通知をプッシュします。

    • OTAFirmwareRequest: OTA更新パッケージに関する情報を要求します。

    • OTAVersionReport: デバイスのOTAモジュールバージョンを送信します。

    • OTAProgressReport: デバイスの更新の進行状況を送信します。

  • データ解析

    • RawDataToProtocol: 生データをAlinkプロトコルデータに変換します。

    • ProtocolToRawData: Alinkプロトコルデータを生データに変換します。

  • TSLデータ送信

    • check: TSL定義に基づいて、送信されたTSLデータを検証します。

    • メッセージ本文のmethodパラメーターの詳細については、「Use topics For communication」をご参照ください。

  • デバイスの動作管理

    • online: デバイスをIoT Platformに接続します。

    • offline: デバイスをIoT Platformから切断します。

第2レベルのビジネス識別子。

Content

ログの内容には、次のパラメーターが含まれます。

  • TraceId: 相互接続されたモジュールの検索に使用できるトレースID。

  • Message: エラーメッセージ。 このパラメーターは、失敗した操作のログに含まれます。

  • Params: リクエストパラメーター。 特定のタイプのログには、このパラメーターが含まれます。

  • ResultData: 操作結果。 結果を生成する操作のログには、このパラメーターが含まれます。

プロダクトのデータ形式が [カスタム] に設定されている場合、TSLデータ解析のログには、デバイスから送信された生データの16進値が含まれます。

Status

HTTP ステータスコード ステータスコード200は、呼び出しが成功したことを示します。 その他のステータスコードは、呼び出しが失敗したことを示します。

API操作に関連するエラーコードの詳細については、「エラーコード」をご参照ください。 その他のエラーコードの詳細については、次のセクションを参照してください。

なし。

デバイスの動作に関連するエラーコード

デバイスの動作ログは、デバイスがオンラインまたはオフラインになると生成されます。

エラーコード

説明

原因

トラブルシューティング

200

デバイスは予想どおりオンラインまたはオフラインになります。

  • オフライン: デバイスはIoT Platformへの接続を閉じます。

  • オンライン: デバイスはIoT Platformへの接続を確立します。

IoT Platformコンソールの [デバイスの詳細] ページで、デバイスの [最終オンライン] パラメーターと [現在のステータス] パラメーターを表示します。

1910

指定されたタイムアウト期間中にMQTTハートビートが検出されないため、デバイスはIoT Platformから切断されます。

IoT Platformがキープアライブ期間内にメッセージを受信しない場合、デバイスはIoT Platformから切断され、サーバーに再接続する必要があります。

MQTTハートビートの詳細については、制限の「MQTTキープアライブメカニズム」セクションを参照してください。

MQTTハートビートがキープアライブ期間中に検出されたかどうかを確認します。

1911

デバイスとIoT Platform間のTCP接続が閉じられているため、デバイスはオフラインになります。

  • デバイス側のファイアウォールまたはNATゲートウェイが非アクティブなTCP接続を検出すると、デバイスはTCP接続を閉じます。

  • TCP接続は、インターネットの複雑なネットワーク環境のために中断される可能性があります。 デバイスがIoT Platformに再接続でき、ビジネスに影響がない場合は、このエラーコードを無視してください。

ネットワーク環境を変更するか、ファイアウォールとゲートウェイの設定を確認して問題のトラブルシューティングを行います。 たとえば、ファイアウォールを無効にすることができます。

説明

TCP接続が頻繁に中断される場合は、TCPDUMPを使用してパケットキャプチャファイルを取得し、チケットを送信できます。

1913

サブデバイスが切断されています。

ゲートウェイが切断されました。

Log Serviceを使用してゲートウェイが切断される理由を確認します。

401

デバイスには権限がありません。

トポロジ関係を追加してサブデバイスを認証すると、サブデバイスの署名の検証に失敗します。

Alinkプロトコルの署名メソッドを使用して、生成された署名と送信された署名を確認します。

Alinkプロトコルの詳細については、「デバイスの登録」をご参照ください。

427

デバイスは例外により切断されています。

デバイス証明書が別のデバイスで使用されているため、デバイスは強制的にオフラインになります。

IoT Platformは、デバイス証明書 (ProductKey、DeviceName、およびDeviceSecret) に基づいてのみデバイスを識別します。

  • 同じデバイス証明書が複数のデバイスで書き込まれます。

  • デバイスのネットワークまたは電源が不安定です。 デバイスは、瞬時にネットワークが停止または停電した後、すぐにIoT Platformに再接続します。 この場合、IoT Platformは再接続されたデバイスを新しいデバイスとして識別します。 エラーメッセージが返された場合でも、デバイスは期待どおりに動作します。

  • コンソールの [デバイスの詳細] ページに移動し、デバイスがIoT Platformに最後に接続された時刻を確認します。 同じデバイス証明書情報を使用して別のデバイスをIoT Platformに接続するかどうかを確認できます。

  • 次のいずれかの方法でネットワーク環境が安定しているかどうかを確認してください。

520

サブデバイスとIoT Platform間のセッションでエラーが発生しました。

  • サブデバイスがIoT Platformに接続されていないか、サブデバイスがすでに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モジュールのバージョンをIoT Platformに送信します。

  • デバイスは、IoT Platformに更新パッケージ情報を要求します。

  • デバイスは、更新の進行状況をIoT Platformに送信します。

アップストリームデータの形式を確認してください。 データ形式の詳細については、「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

  • コンシューマーグループはオフラインです。

  • デバイスがオフラインです。

  • サーバー側サブスクリプションに関連付けられているコンシューマーグループはオフラインです。

  • Pub操作を呼び出してデバイスにメッセージを送信すると、デバイスはオフラインになります。

  • IoT Platformコンソールに移動し、[メッセージ転送] > [サーバー側サブスクリプション] を選択し、[コンシューマーグループ] をクリックします。 [コンシューマーグループ] タブで、[コンシューマーグループのステータス] を表示します。 [消費ログ] タブで、コンシューマーグループがIoT Platformに接続および切断された理由を表示します。

  • IoT Platformコンソールに移動し、[デバイス] > [デバイス] を選択します。 [デバイス] ページで、デバイスのステータスを表示します。

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型の定義された形式に準拠していません。

  • デバイスがプロパティを送信したときに生成されるログを表示します。

  • IoT PlatformコンソールでTSLモデルを表示します。

6335

デバイスがプロパティ構成要求への応答として送信するメッセージのパラメーターが空ではありません。

デバイスがIoT Platformから送信されたプロパティ設定要求に応答する場合、dataフィールドで示される応答データは空である必要があります。

  • デバイスプロパティレポートに関するIoT Platformログを表示し、デバイスによって送信されたデータを確認します。

  • オンプレミスデバイスログを表示して、送信されたデータを確認します。

6336

TSLモデルの時間パラメーターの値が無効です。

デバイスがTSLプロパティまたはTSLイベントのデータを送信すると、データのtimeパラメーターの値が要件を満たしていません。

重要

デバイスは、TSLプロパティとTSLイベントのデータを24時間以内に送信できます。

TSLプロパティまたはTSLイベントの送信データのtimeパラメーターの値がすべての要件を満たしているかどうかを確認します。

5490

指定されたTSLモジュールは存在しません。

指定されたカスタムTSLモジュールは存在しません。

  • IoT Platformコンソールで、カスタムTSLモジュールの識別子を表示し、必要なパラメーターに有効な値が指定されているかどうかを確認します。

  • IoT Platformコンソールで、指定されたカスタムTSLモジュールが削除されているかどうかを確認します。

5092

このプロパティはTSLモデルに存在しません。

アップストリームまたはダウンストリームメッセージのプロパティは、TSLモデルで定義されていません。

重要

カスタムTSLモジュールで定義されているプロパティの場合、{tsl.functionBlockId }:{ tsl.properties.identifier} 形式のモジュール識別子とプロパティを連結する必要があります。

  • デバイスがプロパティを送信したときに生成されるログを表示します。

  • IoT PlatformコンソールでTSLモデルのプロパティを表示します。

5094

サービスはTSLモデルに存在しません。

サービスがTSLモデルで定義されていないか、サービスパラメーターが無効です。

重要

カスタムTSLモジュールで定義されているサービスの場合、サービスを {tsl.functionBlockId }:{ tsl.service.identifier} 形式のモジュール識別子と連結する必要があります。

  • デバイスがプロパティを送信したときに生成されるログを表示します。

  • IoT PlatformコンソールでTSLモデルのサービスを表示します。

5096

イベントはTSLモデルに存在しません。

イベントがTSLモデルで定義されていないか、イベントパラメーターが無効です。

重要

カスタムTSLモジュールで定義されているイベントの場合、{tsl.functionBlockId }:{ tsl.event.identifier} 形式のモジュール識別子とイベントを組み合わせる必要があります。

  • デバイスがプロパティを送信したときに生成されるログを表示します。

  • IoT Platformコンソールで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モデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。

  • パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。

  • パラメーター値がTSLモデルの定義範囲内ではありません。

IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、入力パラメーターがTSLモデルで定義されているデータ型の要件を満たしていることを確認します。

6307

入力パラメーターが、TSLモデルで定義されている32ビットの浮動小数点データ型と一致しません。

IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。

  • パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。

  • パラメーター値がTSLモデルの定義範囲内ではありません。

IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターのデータ型が定義されたデータ型と同じであり、パラメーター値が定義された範囲内にあることを確認してください。

6322

入力パラメーターが、TSLモデルで定義されている64ビット浮動小数点データ型と一致しません。

IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。

  • パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。

  • パラメーター値がTSLモデルの定義範囲内ではありません。

IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターのデータ型が定義されたデータ型と同じであり、パラメーター値が定義された範囲内にあることを確認してください。

6308

入力パラメーターが、TSLモデルで定義されているブール型のデータ型と一致しません。

IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。

  • パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。

  • パラメーター値がTSLモデルの定義範囲内ではありません。

IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、入力パラメーターがTSLモデルで定義されているデータ型の要件を満たしていることを確認します。

6309

入力パラメーターが、TSLモデルで定義されているENUMデータ型と一致しません。

パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。

IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターが定義されたデータ型の要件を満たしていることを確認します。

6310

入力パラメーターが、TSLモデルで定義されているテキストデータ型と一致しません。

IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。

  • パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。

  • パラメーターの長さが、TSLモデルで定義されている制限を超えています。

IoT Platformコンソールの [製品の詳細] ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターが定義されたデータ型の要件を満たしていることを確認します。

6311

入力パラメーターが、TSLモデルで定義されている日付データ型と一致しません。

IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。

  • パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。

  • 入力日付パラメーターはUTCタイムスタンプではありません。

IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示します。 入力パラメーターが定義されたデータ型の要件を満たしていることを確認します。

6312

入力パラメーターは、TSLモデルで定義されている構造体データ型の要件を満たしていません。

IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。

  • パラメーターのデータ型は、TSLモデルで定義されているデータ型とは異なります。

  • 構造内のパラメーターの数は、TSLモデルで定義されているパラメーターの数とは異なります。

IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、入力パラメーターがTSLモデルで定義されているデータ型の要件を満たしていることを確認します。

6304

入力パラメーターがTSL構造に存在しません。

IoT Platformは、入力パラメータが構造内に配置されなかったため、TSLモデルに基づいて入力パラメータを検証できませんでした。

IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、入力パラメーターが定義された構造データ型に存在することを確認します。

6324

入力パラメーターが、TSLモデルで定義されている配列データ型と一致しません。

IoT PlatformがTSLモデルに基づいてパラメーターを検証すると、次のエラーが発生する可能性があります。

  • 配列内の要素が、TSLモデルで定義されている配列構文に準拠していません。

  • 配列内の要素数が、TSLモデルで定義されている最大数を超えています。

  • IoT Platformコンソールの製品詳細ページに移動します。 [機能の定義] タブで、TSLモデルを表示し、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に存在します。

原因:

  • アップロードするファイルは、IoT Platformにアップロードされたファイルと同じ名前です。

  • 同じ名前のファイルに対して指定された処理ポリシーでは、アップロードされたファイルがIoT Platformの既存のファイルを上書きすることはできません。 2つのファイルの名前は同じです。

次の項目を確認してください。

  • ファイル名が一意かどうかを確認してください。

  • 同名のファイルの処理ポリシーがoverwriteかどうかを確認してください。

詳細については、サンプルコードの「ファイルのアップロード要求の開始」をご参照ください。

78129

デバイスがIoT Platformにアップロードしたファイルの数が制限を超えています。

IoT Platformは、各デバイスからアップロードされる最大1,000個のファイルを保存できます。

デバイスがIoT Platformにアップロードしたファイルの数が1,000を超えています。

デバイスがIoT Platformにアップロードしたファイルの数が制限を超えていないか確認します。

IoT Platform API操作に関連するエラーコード

IoT Platform API操作を呼び出したときに返されるエラーコードの詳細については、「エラーコード」をご参照ください。