IoT Platform memungkinkan perangkat mengunggah file ke bucket Object Storage Service (OSS) atau penyimpanan file IoT Platform melalui MQTT, sehingga mengurangi beban perangkat keras dan biaya pengembangan. Konfigurasikan C Link SDK untuk mengaktifkan fitur pengunggahan file pada perangkat Anda.
Prasyarat
-
Anda telah memperoleh C Link SDK.
Untuk menyesuaikan SDK, pada halaman SDK Customization, di area Advanced Features, pilih File Upload.
Informasi latar belakang
-
IoT Platform menyediakan fitur File management untuk file yang diunggah.
-
Setelah perangkat mengunggah file, kelola file tersebut melalui API cloud berikut:
Cara kerja
Perangkat mengunggah file ke IoT Platform melalui MQTT:
-
Referensi API pengunggahan MQTT: aiot_mqtt_upload_api.h.
-
Pengunggahan file memerlukan MQTT connection.
-
Diagram sekuens untuk ./demos/mqtt_upload_basic_demo.c:
Batasan
-
Perangkat hanya dapat mengunggah file menggunakan protokol MQTT di wilayah China (Shanghai), China (Beijing), dan China (Shenzhen).
-
Persyaratan nama file:
-
Karakter yang didukung adalah angka, huruf, garis bawah (_), dan titik (.).
-
Karakter pertama harus berupa huruf atau angka.
-
Panjang maksimum adalah 100 byte.
-
-
Pengunggahan file multiple didukung.
-
Total penyimpanan maksimum per instans: 1 GB.
-
Jumlah file maksimum per perangkat: 1.000.
-
Ukuran file tunggal maksimum: 16 MB.
-
IoT Platform menerapkan kebijakan penanganan konflik berbasis nama file untuk setiap permintaan unggah:
-
Jika tidak ada file dengan nama yang sama, tugas unggah baru akan dibuat.
-
Jika file dengan nama yang sama sudah ada, IoT Platform menerapkan kebijakan penanganan duplikat yang dikonfigurasi. Contoh kode: Langkah 4: Meminta pengunggahan file.
Policy (conflictStrategy)
Description
Overwrite mode (overwrite)
Bawaan. Menghapus file yang sudah ada dan hanya menyimpan unggahan baru.
Append mode (append)
IoT Platform mengembalikan informasi tentang file yang sudah ada. Perangkat dapat:
-
Jika file diunggah sebagian, lanjutkan proses unggah.
CatatanUnggahan yang belum lengkap hanya disimpan selama 24 jam.
-
Jika file telah diunggah sepenuhnya, gunakan mode overwrite atau ubah nama file sebelum mengunggah ulang.
Reject mode (reject)
IoT Platform mengembalikan kode kesalahan yang menunjukkan file sudah ada dan menolak permintaan unggah.
-
-