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

IoT Platform:ファイルアップロードの概要

最終更新日:Jun 04, 2026

IoT Platform では、デバイスが MQTT を使用して、ご利用の Object Storage Service (OSS) バケットまたは IoT Platform のファイルストレージにファイルをアップロードできます。これにより、ハードウェアのオーバーヘッドおよび開発コストを削減できます。C Link SDK を設定して、デバイスでのファイルアップロードを有効にしてください。

前提条件

背景情報

仕組み

デバイスは、MQTT を使用して IoT Platform にファイルをアップロードします。

  • MQTT アップロード API リファレンス:aiot_mqtt_upload_api.h

  • ファイルアップロードにはMQTT 接続が必要です。

  • ./demos/mqtt_upload_basic_demo.c のシーケンス図:MQTT file upload

制限事項

  • デバイスは、中国 (上海)、中国 (北京)、および中国 (深セン) リージョンでのみ MQTT プロトコルを使用してファイルをアップロードできます。

  • ファイル名の要件:

    • 使用可能な文字は、数字、英字、アンダースコア (_)、およびピリオド (.) です。

    • 先頭文字は英字または数字である必要があります。

    • 最大長は 100 バイトです。

  • 複数ファイルのアップロードがサポートされています。

  • インスタンスあたりの最大ストレージ容量:1 GB。

  • デバイスあたりの最大ファイル数:1,000。

  • 単一ファイルの最大サイズ:16 MB。

  • IoT Platform は、各アップロードリクエストに対してファイル名に基づく競合ポリシーを適用します。

    • 同名のファイルが存在しない場合、新しいアップロードタスクが作成されます。

    • 同名のファイルが存在する場合、IoT Platform は設定された重複処理ポリシーを適用します。サンプルコード:ステップ 4:ファイルアップロードリクエストの送信

      ポリシー (conflictStrategy)

      説明

      上書きモード (overwrite)

      デフォルト。既存のファイルを削除し、新しいアップロードのみを保持します。

      追加モード (append)

      IoT Platform は既存ファイルに関する情報を返します。デバイスは以下を行えます。

      • ファイルが部分的にアップロード済みの場合、アップロードを再開します。

        説明

        未完了のアップロードは 24 時間のみ保持されます。

      • ファイルが完全にアップロード済みの場合、上書きモードを使用するか、再アップロード前にファイル名を変更します。

      拒否モード (reject)

      IoT Platform は、ファイルがすでに存在することを示すエラーコードを返し、アップロードリクエストを拒否します。