Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengunggah Objek
Saat Anda mengunggah file ke Amazon S3, file tersebut disimpan sebagai objek S3. Objek terdiri dari data file dan metadata yang menjelaskan objek tersebut. Anda dapat memiliki jumlah objek tak terbatas dalam satu bucket. Sebelum Anda dapat mengunggah file ke bucket Amazon S3, Anda memerlukan izin menulis untuk bucket tersebut. Untuk informasi selengkapnya tentang izin akses, lihat Identity and Access Management untuk Amazon S3.
Anda dapat mengunggah jenis file apa pun—gambar, cadangan, data, film, dan sebagainya—ke dalam bucket S3. Ukuran maksimum file yang dapat Anda unggah menggunakan konsol Amazon S3 adalah 160 GB. Untuk mengunggah file yang lebih besar dari 160 GB, gunakan AWS Command Line Interface (AWS CLI), AWS SDKs, atau Amazon S3 RESTAPI.
Jika Anda mengunggah sebuah objek dengan nama kunci yang sudah ada dalam bucket yang diaktifkan dengan Penentuan Versi, Amazon S3 membuat versi lain dari objek tersebut dan bukan mengganti objek yang ada. Untuk informasi selengkapnya tentang mengaktifkan pembuatan versi, lihat. Mengaktifkan Penentuan Versi pada bucket
Tergantung dari ukuran data yang Anda unggah, Amazon S3 menawarkan opsi berikut:
-
Unggah objek dalam satu operasi dengan menggunakan AWS SDKs, RESTAPI, atau AWS CLI— Dengan satu
PUT
operasi, Anda dapat mengunggah satu objek hingga 5 GB. -
Unggah objek tunggal menggunakan konsol Amazon S3 –Dengan konsol Amazon S3, Anda dapat mengunggah objek tunggal yang berukuran hingga 160 GB.
-
Unggah objek dalam beberapa bagian dengan menggunakan AWS SDKs, RESTAPI, atau AWS CLI— Menggunakan API operasi unggahan multipart, Anda dapat mengunggah satu objek besar, hingga 5 TB.
APIOperasi pengunggahan multibagian dirancang untuk meningkatkan pengalaman unggah untuk objek yang lebih besar. Anda dapat mengunggah objek dalam beberapa bagian. Bagian-bagian objek ini dapat diunggah secara mandiri, dalam urutan apa pun, dan secara paralel. Anda dapat menggunakan unggahan multibagian untuk objek dengan ukuran mulai dari 5 MB hingga 5 TB. Untuk informasi selengkapnya, lihat Mengunggah dan menyalin objek menggunakan unggahan multibagian.
Saat Anda mengunggah objek, objek secara otomatis dienkripsi menggunakan enkripsi sisi server dengan kunci terkelola Amazon S3 (-S3) secara default. SSE Saat Anda mengunduhnya, objek tersebut didekripsi. Untuk informasi selengkapnya, silakan lihat Mengatur perilaku enkripsi di sisi server default untuk bucket Amazon S3 dan Melindungi data dengan enkripsi.
Saat Anda mengunggah objek, jika Anda ingin menggunakan jenis enkripsi default yang berbeda, Anda juga dapat menentukan enkripsi sisi server dengan AWS Key Management Service (AWS KMS) keys (SSE-KMS) dalam PUT
permintaan S3 Anda atau atur konfigurasi enkripsi default di bucket tujuan untuk digunakan SSE - KMS untuk mengenkripsi data Anda. Untuk informasi lebih lanjut tentang SSE -KMS, lihatMenentukan enkripsi sisi server dengan AWS KMS
(SSE-KMS). Jika Anda ingin menggunakan KMS kunci yang dimiliki oleh akun lain, Anda harus memiliki izin untuk menggunakan kunci tersebut. Untuk informasi selengkapnya tentang izin lintas akun untuk KMS kunci, lihat Membuat KMS kunci yang dapat digunakan akun lain di AWS Key Management Service Panduan Pengembang.
Jika Anda menemukan error Access Denied (403 Forbidden) di Amazon S3, Memecahkan masalah akses ditolak (403 Forbidden) kesalahan di Amazon S3 lihat untuk mempelajari lebih lanjut tentang penyebab umumnya.
Mengunggah objek
Prosedur ini menjelaskan cara untuk mengunggah objek dan folder ke bucket Amazon S3 menggunakan konsol tersebut.
Ketika Anda mengunggah objek, nama kunci objek adalah nama file dan prefiks opsional. Di konsol Amazon S3, Anda dapat membuat folder untuk mengatur objek Anda. Di Amazon S3, folder diwakili sebagai prefiks yang muncul dalam nama kunci objek. Jika Anda mengunggah objek individu ke folder di konsol Amazon S3, nama folder disertakan dalam nama kunci objek.
Misalnya, jika Anda mengunggah sebuah objek bernama sample1.jpg
ke folder bernama backup
, nama kuncinya adalah backup/sample1.jpg
. Namun, objek ditampilkan di konsol sebagai sample1.jpg
dalam folder backup
. Untuk informasi selengkapnya tentang nama kunci, lihat Bekerja dengan metadata objek.
catatan
Jika Anda mengganti sebuah objek atau mengubah properti apa pun di konsol Amazon S3, misalnya Kelas Penyimpanan, Enkripsi, atau Metadata, sebuah objek baru dibuat untuk menggantikan yang lama. Jika Penentuan Versi S3 diaktifkan, versi baru objek akan dibuat, dan objek yang sudah ada menjadi versi yang lebih lama. Peran yang mengubah properti juga menjadi pemilik objek baru (atau versi objek).
Saat Anda mengunggah folder, Amazon S3 mengunggah semua file dan subfolder dari folder yang ditentukan ke bucket Anda. Kode tersebut kemudian menetapkan nama kunci objek yang merupakan kombinasi nama file unggahan dan nama folder. Misalnya, jika Anda mengunggah folder bernama /images
yang berisi dua file, sample1.jpg
dan sample2.jpg
, Amazon S3 mengunggah file tersebut dan kemudian menetapkan nama kunci yang sesuai, images/sample1.jpg
dan images/sample2.jpg
. Nama-nama kunci termasuk nama folder sebagai prefiks. Konsol Amazon S3 hanya menampilkan bagian dari nama kunci yang mengikuti /
yang terakhir. Misalnya, dalam folder images
, objek images/sample1.jpg
dan images/sample2.jpg
ditampilkan sebagai sample1.jpg
dan sample2.jpg
.
Untuk mengunggah file dan folder ke bucket S3
Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/
-
Di panel navigasi kiri, pilih Bucket.
-
Di dalam daftar Bucket, pilih nama bucket tempat Anda ingin mengunggah folder dan file.
-
Pilih Unggah.
-
Di jendela Unggah, lakukan salah satu hal berikut:
-
Seret dan jatuhkan file dan folder ke jendela Unggah.
-
Pilih Tambahkan file atau Tambahkan folder, pilih file atau folder untuk diunggah, dan pilih Buka.
-
-
Untuk mengaktifkan Penentuan Versi, di bawah Tujuan memilih Aktifkan Penentuan Versi Bucket.
-
Untuk mengunggah file dan folder yang terdaftar tanpa mengonfigurasi opsi pengunggahan tambahan, di bagian bawah halaman, pilih Unggah.
Amazon S3 mengunggah objek dan folder Anda. Setelah unggahan selesai, Anda melihat pesan sukses di halaman Unggahan: status.
Untuk mengonfigurasi properti objek tambahan
-
Untuk mengubah izin daftar kontrol akses, pilih Izin.
-
Di bawah Access control list (ACL), edit izin.
Untuk informasi selengkapnya tentang izin akses objek, lihat Menggunakan konsol S3 untuk mengatur ACL izin untuk objek. Anda dapat memberikan akses baca ke objek Anda kepada publik (semua orang di dunia) untuk semua file yang Anda unggah. Namun, kami merekomendasikan untuk tidak mengubah pengaturan default untuk mengakses baca publik. Pemberian akses baca publik berlaku untuk sebagian kecil kasus penggunaan, seperti saat bucket digunakan untuk situs web. Anda dapat selalu mengubah izin objek setelah Anda mengunggah objek.
-
Untuk mengonfigurasi properti tambahan lainnya, pilih Properti.
-
Di bagian bawah Kelas penyimpanan pilih kelas penyimpanan untuk file yang Anda unggah.
Untuk informasi selengkapnya tentang kelas penyimpanan, lihat Menggunakan kelas penyimpanan Amazon S3.
-
Untuk memperbarui pengaturan enkripsi untuk objek Anda, di bagian bawah Pengaturan enkripsi di sisi server, lakukan hal berikut.
-
Pilih Tentukan kunci enkripsi.
Di bawah Pengaturan enkripsi, pilih Gunakan pengaturan bucket untuk enkripsi default, atau Ganti pengaturan bucket untuk enkripsi default.
-
Jika Anda memilih Ganti pengaturan bucket untuk enkripsi default, Anda harus mengonfigurasi pengaturan enkripsi berikut.
Untuk mengenkripsi file yang diunggah menggunakan kunci yang dikelola oleh Amazon S3, pilih kunci terkelola Amazon S3 (-S3). SSE
Untuk informasi selengkapnya, lihat Menggunakan enkripsi sisi server dengan kunci terkelola Amazon S3 (-S3) SSE.
-
Untuk mengenkripsi file yang diunggah dengan menggunakan kunci yang disimpan di AWS Key Management Service (AWS KMS), pilih AWS Key Management Service kunci (SSE-KMS). Kemudian pilih salah satu opsi berikut untuk AWS KMS kunci:
-
Untuk memilih dari daftar KMS kunci yang tersedia, pilih Pilih dari AWS KMS keys, dan kemudian pilih KMSkunci Anda dari daftar kunci yang tersedia.
Keduanya Kunci yang dikelola AWS (
aws/s3
) dan kunci terkelola pelanggan Anda muncul dalam daftar ini. Untuk informasi selengkapnya tentang kunci yang dikelola pelanggan, lihat Kunci pelanggan dan AWS kunci di AWS Key Management Service Panduan Pengembang. -
Untuk memasukkan KMS kunciARN, pilih Enter AWS KMS key ARN, dan kemudian masukkan KMS kunci Anda ARN di bidang yang muncul.
-
Untuk membuat kunci terkelola pelanggan baru di AWS KMS konsol, pilih Buat KMS kunci.
Untuk informasi lebih lanjut tentang membuat AWS KMS key, lihat Membuat kunci di AWS Key Management Service Panduan Pengembang.
penting
Anda hanya dapat menggunakan KMS tombol yang tersedia di tempat yang sama Wilayah AWS sebagai ember. Konsol Amazon S3 hanya mencantumkan 100 KMS kunci pertama di Wilayah yang sama dengan bucket. Untuk menggunakan KMS kunci yang tidak terdaftar, Anda harus memasukkan KMS kunci AndaARN. Jika Anda ingin menggunakan KMS kunci yang dimiliki oleh akun yang berbeda, Anda harus terlebih dahulu memiliki izin untuk menggunakan kunci tersebut dan kemudian Anda harus memasukkan KMS kunci tersebutARN.
Amazon S3 hanya mendukung KMS kunci enkripsi simetris, dan bukan kunci asimetris. KMS Untuk informasi selengkapnya, lihat Mengidentifikasi KMS kunci simetris dan asimetris di AWS Key Management Service Panduan Pengembang.
-
-
-
Untuk menggunakan checksum tambahan, pilih Aktif. Kemudian untuk Fungsi checksum, pilih fungsi yang ingin Anda gunakan. Amazon S3 menghitung dan menyimpan nilai checksum setelah menerima objek secara keseluruhan. Anda dapat menggunakan kotak Nilai prakalkulasi untuk memberikan nilai yang telah dihitung sebelumnya. Jika sudah, Amazon S3 membandingkan nilai yang Anda berikan dengan nilai yang dihitung. Jika kedua nilai tidak cocok, Amazon S3 menghasilkan kesalahan.
Checksum tambahan memungkinkan Anda menentukan algoritma checksum yang ingin Anda gunakan untuk memverifikasi data Anda. Untuk informasi selengkapnya tentang checksum tambahan, lihat Memeriksa integritas objek.
-
Untuk menambahkan tanda ke semua objek yang Anda unggah, pilih Tambahkan tag. Masukkan nama tag di bidang Kunci. Masukkan nilai untuk tanda.
Penandaan objek memberi Anda cara untuk mengategorikan penyimpanan. Setiap tag adalah pasangan nilai kunci. Kunci dan nilai tag peka huruf besar dan kecil. Anda dapat membuat hingga 10 tanda per objek. Kunci tanda dapat terdiri dari hingga 128 karakter Unicode, dan nilai tanda dapat terdiri dari hingga 256 karakter Unicode. Untuk informasi selengkapnya tentang tag objek, lihat Mengategorikan penyimpanan Anda menggunakan tag.
-
Untuk menambahkan metadata, pilih Tambahkan metadata.
-
Di bawah Jenis, pilih Ditentukan sistem atau Ditentukan pengguna.
Untuk metadata yang ditentukan sistem, Anda dapat memilih HTTP header umum, seperti Content-Type dan Content-Disposition. Untuk daftar metadata yang ditentukan sistem, serta informasi tentang apakah Anda dapat menambahkan nilai, lihat Metadata objek yang ditentukan sistem. Metadata apa pun yang dimulai dengan prefiks
x-amz-meta-
diperlakukan sebagai metadata yang ditentukan pengguna. Metadata yang ditentukan pengguna disimpan bersama objek, dan dikembalikan saat Anda mengunduh objek tersebut. Baik kunci maupun nilai-nilainya harus sesuai dengan ASCII standar AS. Metadata yang ditentukan pengguna dapat berukuran sebesar 2 KB. Untuk informasi selengkapnya tentang metadata yang ditentukan sistem dan yang ditentukan pengguna, lihat Bekerja dengan metadata objek. -
Untuk Kunci, pilih kuncinya.
-
Ketikkan nilai untuk kunci tersebut.
-
-
Untuk mengunggah objek Anda, pilih Unggah.
Amazon S3 mengunggah objek Anda. Setelah unggahannya selesai, Anda dapat melihat pesan sukses di halaman Unggah: status.
-
Pilih Keluar.
Anda dapat mengirim permintaan PUT
untuk mengunggah objek hingga 5 GB dalam satu operasi. Untuk informasi selengkapnya, lihat PutObject
contoh di AWS CLI Referensi Perintah.
Anda dapat mengirim REST permintaan untuk mengunggah objek. Anda dapat mengirim permintaan PUT
untuk mengunggah dalam satu operasi. Untuk informasi selengkapnya, lihat PUTObjek.
Anda dapat menggunakan AWS SDKsuntuk mengunggah objek di Amazon S3. Pustaka pembungkus SDKs menyediakan bagi Anda untuk mengunggah data dengan mudah. Untuk selengkapnya, lihat Daftar yang didukung SDKs.
Berikut adalah beberapa contoh dengan beberapa pilihanSDKs:
Mencegah mengunggah objek dengan nama kunci yang identik
Anda dapat memeriksa keberadaan objek di bucket Anda sebelum membuatnya menggunakan penulisan bersyarat pada operasi unggahan. Ini dapat mencegah penimpaan data yang ada. Penulisan bersyarat akan memvalidasi tidak ada objek yang ada dengan nama kunci yang sama yang sudah ada di bucket Anda saat mengunggah.
Anda dapat menggunakan penulisan bersyarat untuk PutObjectatau CompleteMultipartUploadpermintaan.
Untuk informasi selengkapnya tentang permintaan bersyarat, lihat,Tambahkan prasyarat ke operasi S3 dengan permintaan bersyarat.