IoT Platform では、デバイスが MQTT を使用して、ご利用の Object Storage Service (OSS) バケットまたは IoT Platform のファイルストレージにファイルをアップロードできます。これにより、ハードウェアのオーバーヘッドおよび開発コストを削減できます。C Link SDK を設定して、デバイスでのファイルアップロードを有効にしてください。
前提条件
-
SDK をカスタマイズするには、SDK カスタマイズ ページの 高度な機能 エリアで、ファイルアップロード を選択します。
背景情報
-
IoT Platform は、アップロードされたファイルを管理するためのファイル管理機能を提供しています。
-
デバイスがファイルをアップロードした後は、以下のクラウド API を使用して管理できます。
仕組み
デバイスは、MQTT を使用して IoT Platform にファイルをアップロードします。
-
MQTT アップロード API リファレンス:aiot_mqtt_upload_api.h。
-
ファイルアップロードにはMQTT 接続が必要です。
-
./demos/mqtt_upload_basic_demo.c のシーケンス図:

制限事項
-
デバイスは、中国 (上海)、中国 (北京)、および中国 (深セン) リージョンでのみ MQTT プロトコルを使用してファイルをアップロードできます。
-
ファイル名の要件:
-
使用可能な文字は、数字、英字、アンダースコア (_)、およびピリオド (.) です。
-
先頭文字は英字または数字である必要があります。
-
最大長は 100 バイトです。
-
-
複数ファイルのアップロードがサポートされています。
-
インスタンスあたりの最大ストレージ容量:1 GB。
-
デバイスあたりの最大ファイル数:1,000。
-
単一ファイルの最大サイズ:16 MB。
-
IoT Platform は、各アップロードリクエストに対してファイル名に基づく競合ポリシーを適用します。
-
同名のファイルが存在しない場合、新しいアップロードタスクが作成されます。
-
同名のファイルが存在する場合、IoT Platform は設定された重複処理ポリシーを適用します。サンプルコード:ステップ 4:ファイルアップロードリクエストの送信。
ポリシー (conflictStrategy)
説明
上書きモード (overwrite)
デフォルト。既存のファイルを削除し、新しいアップロードのみを保持します。
追加モード (append)
IoT Platform は既存ファイルに関する情報を返します。デバイスは以下を行えます。
-
ファイルが部分的にアップロード済みの場合、アップロードを再開します。
説明未完了のアップロードは 24 時間のみ保持されます。
-
ファイルが完全にアップロード済みの場合、上書きモードを使用するか、再アップロード前にファイル名を変更します。
拒否モード (reject)
IoT Platform は、ファイルがすでに存在することを示すエラーコードを返し、アップロードリクエストを拒否します。
-
-