API Penyimpanan Objek
Penyimpanan objek kompatibel S3. Terbitkan kredensial terpisah per bucket, hubungkan SDK S3 langsung, dengan trafik keluar pembacaan gratis.
- Kredensial: Access Key / Secret Key diterbitkan per bucket dan hanya valid untuk bucket tersebut; rahasia ditampilkan sekali dan kunci baru aktif sekitar satu menit kemudian
- Pengaturan SDK: region selalu auto dengan pengalamatan virtual-host; contoh Node.js / Python / Go / PHP / aws-cli
- CORS: wajib sebelum peramban mengunggah atau membaca langsung; origin harus domain spesifik, bukan wildcard
- URL bertanda tangan sementara: unggahan dan unduhan dapat diberi tanda tangan, sehingga peramban menerima tautan berbatas waktu, bukan kunci
- Batas dan harga: 5 GiB per PUT tunggal dan hingga 10000 bagian multipart; penyimpanan ditagih berdasarkan pemakaian aktual harian, penghapusan dan trafik keluar gratis
Ringkasan
Penyimpanan objek S3: kredensial per bucket, SDK apa pun, tanpa biaya keluar.
aws-sdk, boto3, s3cmd, rclone tetap; ganti endpoint dan region=auto.
Kredensial
Terbitkan per bucket di Penyimpanan Objek → Bucket → Kunci. Hanya bucket itu dapat diakses.
- Endpoint — Endpoint S3, mis. https://<account>.r2.cloudflarestorage.com
- Bucket — Nama sebenarnya bucket, dengan prefiks sistem, berbeda dari alias Anda
- Access Key ID — Access Key ID
- Secret Access Key — Secret Access Key ditampilkan sekali saat pembuatan
- Region — Selalu auto. us-east-1 dll. merusak tanda tangan dan 403 SignatureDoesNotMatch.
Kredensial baru butuh sekitar semenit mencapai edge; sementara 401 Unauthorized. Bukan kunci salah — tunggu dan ulang. Ini sering salah didiagnosis saat awal.
Secret Access Key tidak disimpan sehingga tidak bisa diambil setelah ditutup. Kehilangan berarti hapus/buat ulang dan integrasi terputus; simpan segera di pengelola rahasia.
Pengaturan SDK
Masukkan empat nilai konsol ke SDK S3 Anda.
Gunakan virtual-host bawaan, bukan path-style. Salah menghasilkan 404 / NoSuchBucket seolah typo nama.
CORS
Browser tidak dapat upload/baca langsung sebelum CORS. Permintaan diblokir sebelum terkirim; error hanya di browser, tidak di server. Atur Bucket → Pengaturan → CORS.
Wildcard mengizinkan situs apa pun baca/tulis dengan kredensial pengunjung tanpa jejak akses yang bisa diperiksa. Daftar domain spesifik.
URL bertanda tangan sementara
Beri URL berbatas waktu, bukan kredensial frontend. Upload/download mendukung presign agar file besar tidak melewati server Anda.
Batas
- 5 GiB per PUT; lebih besar gunakan multipart
- Hingga ~4.995 TiB per objek multipart, maksimum 10,000 bagian
- Kunci objek hingga 1024 byte
- Satu penulisan bersamaan per detik ke kunci sama
Harga
Dalam kuota tanpa biaya ekstra; selebihnya tarif berikut.
- Penyimpanan — $0.03 / GB·bulan — Menurut penggunaan harian nyata, bukan puncak
- $9.00 / 1M — Tulis/daftar PutObject, ListObjects, multipart, …
- $0.72 / 1M — Baca GetObject, HeadObject, …
- Trafik keluar — Gratis — Bandwidth baca gratis, perbedaan biaya utama dari penyimpanan tradisional
- Penghapusan — Gratis — Hapus objek/bucket dan batalkan multipart gratis
Lebih murah per GB, tetapi minimum retensi 30 hari (hapus dini tetap tagih 30 hari) dan tiap baca berbiaya. Bucket dibaca harian lebih mahal; cocok arsip/cadangan yang sering ditulis, jarang dibaca.
Pertanyaan umum
Mengapa kredensial baru terus menghasilkan 401?
Kredensial baru memerlukan sekitar satu menit untuk diterapkan pada node penyimpanan, dan panggilan selama waktu itu menghasilkan 401 Unauthorized. Itu tidak selalu berarti kunci salah; tunggu sebentar lalu coba lagi. Kondisi ini sering keliru didiagnosis saat integrasi pertama.
Region apa yang dipakai dan apa penyebab SignatureDoesNotMatch?
Region selalu auto. Menggunakan us-east-1 atau nilai serupa merusak tanda tangan dan permintaan menghasilkan 403 SignatureDoesNotMatch. Gunakan pengalamatan virtual-host dan jangan aktifkan path-style; kesalahan itu menghasilkan 404 NoSuchBucket.
Halaman terkait: Dokumentasi API · Layanan Cloud Tovanix · Menggunakan domain
Memuat…