Gunakan Penyimpanan App untuk menyimpan, mengatur, dan mengelola file yang digunakan oleh app Anda yang sedang berjalan, termasuk gambar, video, dokumen, dan unggahan pengguna.

Sebelum menggunakan Penyimpanan App, hubungkan proyek ke Atoms Cloud. Jika belum terhubung, minta Agen untuk menghubungkan Atoms Cloud atau ikuti Atoms Cloud.

Memahami Penyimpanan App di Atoms Cloud

Penyimpanan App menyimpan file yang perlu disimpan dan diakses oleh proyek Anda. Ini terpisah dari data terstruktur yang disimpan di Basis Data Anda, file yang diunggah di Chat, dan file yang membentuk kode proyek Anda.

Istilah penting

• Bucket: Kontainer utama yang digunakan untuk menyimpan dan mengelompokkan file terkait. Anda dapat menganggap bucket seperti area penyimpanan untuk satu kategori file. Setiap bucket diatur sebagai Public atau Private, yang mengontrol siapa yang dapat mengakses file di dalamnya.
• Folder: Cara opsional untuk mengatur file di dalam bucket. Folder bekerja seperti folder di komputer Anda dan dapat membantu membuat koleksi file yang lebih besar lebih mudah dikelola.
• Object: File individual yang disimpan dalam bucket atau folder, seperti gambar, dokumen, video, atau file lain yang diunggah.
• Object key: Jalur unik yang digunakan untuk mengidentifikasi lokasi penyimpanan file di dalam bucket. Misalnya, images/profile/avatar.png dapat menjadi object key untuk gambar yang disimpan di dalam folder images/profile.

Pilih Public atau Private

Pilih jenis bucket sebelum membuatnya:

Jenis bucket	Gunakan untuk
Private	File sensitif, khusus akun, atau file yang diunggah pengguna.
Public	File non-sensitif yang memang aman untuk diekspos secara publik.

Gunakan Private untuk file sensitif atau file khusus pengguna. Jika Anda mengalami error akses, jangan ubah bucket menjadi Public hanya agar file dapat diakses. Sebagai gantinya, pastikan app Anda memeriksa bahwa orang yang meminta file memang memiliki izin untuk mengaksesnya.

Buka Penyimpanan App di Atoms Cloud

1. Buka proyek Anda di perangkat desktop.
2. Di toolbar ruang kerja yang sama tempat Penampil App berada, pilih Atoms Cloud.
3. Pilih Penyimpanan App di sidebar Atoms Cloud.

Izin di Penyimpanan App

Penyimpanan App menggunakan peran ruang kerja Anda. Baik Editor maupun pemilik ruang kerja dapat mengelola penyimpanan untuk proyek yang dapat mereka buka. Orang yang bukan anggota ruang kerja tidak dapat membuka atau mengelola Penyimpanan App proyek.

Pengaturan Public atau Private pada bucket tidak mengubah siapa yang dapat mengelolanya di Atoms Cloud. Pengaturan tersebut mengontrol bagaimana app yang sedang berjalan dapat memberikan akses ke file; izin ruang kerja mengontrol siapa yang dapat mengelola penyimpanan dari ruang kerja Atoms Cloud.

Buat bucket

Sebuah app dapat memiliki hingga 10 bucket. Buat bucket terpisah ketika kelompok file yang berbeda memerlukan pengaturan akses yang berbeda atau perlu dipisahkan agar lebih mudah diatur.

1. Di halaman Penyimpanan App, pilih Create Bucket.
2. Di bawah Bucket Name, masukkan nama unik untuk bucket. Nama tersebut harus:
   • berisi 3–63 karakter;
   • hanya menggunakan huruf kecil, angka, dan tanda hubung; dan
   • diawali dan diakhiri dengan huruf atau angka.
3. Di bawah Bucket Type, pilih Private atau Public. Public dipilih secara default, jadi pastikan Anda memilih tingkat akses yang diinginkan sebelum melanjutkan.
4. Pilih Create.

Bucket baru muncul di halaman Penyimpanan App dengan nama, jenis, dan tanggal pembuatannya. Pilih bucket untuk membukanya dan melihat isinya.

Pilih Create Bucket di Penyimpanan App.

Nama bucket tidak dapat diubah setelah dibuat, jadi pilih nama yang jelas dan tidak perlu Anda ubah nanti. Jika app Anda sudah memiliki 10 bucket, Create Bucket tidak akan lagi tersedia.

Unggah dan atur file

Di dalam bucket, Anda dapat mengunggah file secara langsung atau membuat folder kosong tanpa mengunggah file apa pun terlebih dahulu.

Buat folder baru

1. Buka bucket atau folder tempat Anda ingin membuat folder baru.
2. Pilih Add Folder.
3. Masukkan nama untuk folder, lalu pilih Create. Nama folder dapat berisi huruf, angka, titik (.), tanda hubung (-), dan garis bawah (_), dan tidak boleh lebih dari 100 karakter. Nama folder tidak dapat diubah setelah dibuat.

Beri nama folder, lalu pilih Create.

Unggah file

1. Buka bucket atau folder tempat Anda ingin menyimpan file.
2. Pilih Upload, lalu pilih satu atau beberapa file dari perangkat Anda. Setiap file dapat berukuran hingga 100 MB.
3. Tunggu hingga unggahan selesai, lalu periksa bahwa file muncul dalam daftar.

Daftar file menampilkan Name, Type, Size, tanggal Last Modified, dan Actions yang tersedia untuk setiap item. Jika Anda perlu memuat ulang isi folder saat ini, pilih tombol refresh.

Unggah file ke bucket atau folder yang dipilih.

Pratinjau dan kelola file

Pilih file untuk membuka File Details. Gambar dan video yang didukung dapat dipratinjau di panel. Jenis file lain menampilkan detail yang tersedia dan tetap dapat diunduh. Jika semua kredit telah digunakan, File Details menampilkan status kredit habis, dan Download untuk satu file akan mengarahkan Anda ke Tingkatkan alih-alih mengunduh.

Kelola satu file

Buka ... di kolom Actions file, lalu pilih:

• Download untuk menyimpan salinan lokal saat kredit tersedia. Jika semua kredit telah digunakan, tindakan ini akan mengarahkan Anda ke Tingkatkan sebagai gantinya.
• Rename untuk mengubah nama file. Nama baru dapat menggunakan huruf, angka, titik, tanda hubung, dan garis bawah.
• Delete untuk menghapus file setelah konfirmasi.

Gunakan menu tindakan file untuk mengunduh, mengganti nama, atau menghapusnya.

Kelola beberapa file

1. Pilih kotak centang di samping setiap file. Folder tidak disertakan dalam pemilihan batch.
2. Pilih Download untuk mengunduh file yang dipilih bersama-sama, atau pilih Delete.
3. Jika menghapus, tinjau jumlah file yang dipilih dan konfirmasikan Delete.

Penghapusan tidak dapat dibatalkan dari Penyimpanan App. Sebelum mengganti nama atau menghapus file, periksa apakah app masih menggunakan object key-nya. Perbarui referensi yang tersimpan setelahnya agar app tidak terus meminta key lama.

Gunakan file yang disimpan di app Anda

App Anda mengidentifikasi setiap file yang disimpan menggunakan nama bucket dan object key-nya. Object key menunjukkan lokasi file di dalam bucket. Misalnya, images/profile/avatar.png dapat menjadi object key untuk gambar yang disimpan di dalam folder images/profile.

Simpan nama bucket dan object key di basis data app Anda agar app dapat menemukan file tersebut nanti. Saat app Anda perlu menampilkan atau mengunduh file, app dapat menggunakan detail ini untuk meminta URL akses.

URL akses mungkin bersifat sementara. Jangan simpan URL tersebut sebagai data app permanen, hardcode ke dalam app Anda, atau bagikan di Chat, tangkapan layar, log, atau pesan dukungan. Sebagai gantinya, simpan object key dan minta URL akses baru saat file perlu diakses.

Jangan simpan API key, kata sandi, atau kredensial lain di Penyimpanan App. Simpan kredensial runtime privat di Kunci and secrets. Hanya pemilik ruang kerja yang dapat mengelola kredensial runtime privat di sana. Jika Anda seorang Editor, minta pemilik ruang kerja untuk menambahkan atau memperbarui kredensial tersebut.

Batas saat ini

Batas	Nilai saat ini
Bucket per app	10
Ukuran setiap file yang diunggah	100 MB

Untuk informasi penggunaan dan kapasitas Cloud saat ini, lihat Cloud & AI Wallet.

FAQ

Ruang disk saya penuh. Bagaimana cara mengosongkan penyimpanan?

1. Periksa penggunaan penyimpanan saat ini dan identifikasi chat, proyek, atau file terbesar.
2. Unduh atau cadangkan apa pun yang mungkin Anda perlukan nanti.
3. Hapus hanya item yang tidak lagi Anda perlukan. Jika menghapus chat menampilkan opsi untuk menghapus data disk terkait, pilih itu hanya setelah memastikan bahwa data tersebut dapat dibuang.
4. Hapus file besar yang tidak diperlukan, lalu segarkan dan periksa kembali ruang yang tersedia.

Penghapusan mungkin bersifat permanen dan dapat memengaruhi proyek yang mereferensikan file yang dihapus. Jika penggunaan tidak berkurang setelah pembersihan, hubungi Support dengan tangkapan layar penyimpanan, paket Anda, dan akun atau ruang kerja yang terdampak. Jangan kirim isi file kecuali diminta melalui saluran yang disetujui.