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](security-iam.md).
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 REST API.
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](manage-versioning-examples.md)
Tergantung dari ukuran data yang Anda unggah, Amazon S3 menawarkan opsi berikut:
+ **Unggah objek dalam satu operasi dengan menggunakan AWS SDKs, REST API, atau AWS CLI** — Dengan satu `PUT` operasi, Anda dapat mengunggah satu objek berukuran 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, REST API, atau AWS CLI** **—** Menggunakan operasi API unggahan multibagian, Anda dapat mengunggah satu objek besar, berukuran hingga 50 TB.
Pengoperasian API unggahan multibagian dirancang untuk meningkatkan pengalaman pengunggahan 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 multipart untuk objek dari ukuran 5 MB hingga 50 TB. Untuk informasi selengkapnya, lihat [Mengunggah dan menyalin objek menggunakan unggahan multipart di Amazon S3](mpuoverview.md).
Untuk mengunggah file yang lebih besar dari 5 TB, gunakan S3 Transfer Manager di Java v1/v2, Python, atau. AWS CLI SDKs Untuk kinerja terbaik, gunakan AWS Common Runtime (CRT) terbaru dengan ini SDKs, yang telah dioptimalkan untuk pemanfaatan sumber daya yang lebih baik.
Saat mengunggah objek besar dari aliran memori, CRT menyangga setiap bagian hingga 5 GB dalam memori, membatasi keseluruhan throughput dengan memori yang dialokasikan. Anda dapat menyesuaikan batas memori CRT menggunakan opsi konfigurasi seperti `maxNativeMemoryLimitInBytes` untuk Java SDK. Untuk unggahan dari disk, CRT secara otomatis beralih ke streaming disk langsung alih-alih buffering bagian menengah, meningkatkan penggunaan memori. Perilaku ini secara otomatis diaktifkan untuk objek besar, tetapi juga dapat diaktifkan untuk file yang lebih kecil melalui parameter permintaan seperti `should_stream` untuk AWS CLI dan `CRT_MEMORY_BUFFER_DISABLED` untuk Java SDK.
Saat Anda mengunggah sebuah objek, objek secara otomatis dienkripsi menggunakan enkripsi di sisi server dengan kunci terkelola Amazon S3 (SSE-S3) secara default. Saat Anda mengunduhnya, objek tersebut didekripsi. Untuk informasi selengkapnya, lihat [Mengatur perilaku enkripsi sisi server default untuk bucket Amazon S3](bucket-encryption.md) dan [Melindungi data dengan enkripsi](UsingEncryption.md).
Saat mengunggah objek, jika ingin menggunakan jenis enkripsi default yang berbeda, Anda juga dapat menentukan enkripsi sisi server dengan AWS Key Management Service (AWS KMS) kunci (SSE-KMS) dalam `PUT` permintaan S3 atau mengatur konfigurasi enkripsi default di bucket tujuan untuk menggunakan SSE-KMS untuk mengenkripsi data Anda. Untuk informasi lebih lanjut tentang SSE-KMS, lihat [Menentukan enkripsi sisi server dengan (SSE-KMS) AWS KMS](specifying-kms-encryption.md). Jika Anda ingin menggunakan kunci KMS yang dimiliki oleh akun lain, Anda harus memiliki izin untuk menggunakan kunci tersebut. Untuk informasi selengkapnya tentang izin lintas akun untuk kunci KMS, lihat [Membuat kunci KMS yang dapat digunakan oleh akun lain](https://docs.aws.amazon.com//kms/latest/developerguide/key-policy-modifying-external-accounts.html#cross-account-console) di *Panduan Pengembang AWS Key Management Service *.
Jika Anda menemukan kesalahan Akses Ditolak (403 Terlarang) di Amazon S3, [Memecahkan masalah kesalahan akses ditolak (403 Forbidden) di Amazon S3](troubleshoot-403-errors.md) lihat untuk mempelajari lebih lanjut tentang penyebab umumnya.
## Mengunggah objek
### Menggunakan konsol S3
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](UsingMetadata.md).
**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**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket**.
1. Di dalam daftar **Bucket**, pilih nama bucket tempat Anda ingin mengunggah folder dan file.
1. Pilih **Unggah**.
1. 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**.
1. Untuk mengaktifkan Penentuan Versi, di bawah **Tujuan** memilih **Aktifkan Penentuan Versi Bucket**.
1. 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**
1. Untuk mengubah izin daftar kontrol akses, pilih **Izin**.
1. Di bagian bawah **Daftar kontrol akses (ACL)**, edit izinnya.
Untuk informasi selengkapnya tentang izin akses objek, lihat [Menggunakan konsol S3 untuk mengatur izin ACL untuk objek](managing-acls.md#set-object-permissions). 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.
1. Untuk mengonfigurasi properti tambahan lainnya, pilih **Properti**.
1. Di bagian bawah **Kelas penyimpanan** pilih kelas penyimpanan untuk file yang Anda unggah.
Untuk informasi selengkapnya tentang kelas penyimpanan, lihat [Memahami dan mengelola kelas penyimpanan Amazon S3](storage-class-intro.md).
1. Untuk memperbarui pengaturan enkripsi untuk objek Anda, di bagian bawah **Pengaturan enkripsi di sisi server**, lakukan hal berikut.
1. Pilih **Tentukan kunci enkripsi**.
1. Di bawah **Pengaturan enkripsi**, pilih **Gunakan pengaturan bucket untuk enkripsi default**, atau **Ganti pengaturan bucket untuk enkripsi default**.
1. Jika Anda memilih **Ganti pengaturan bucket untuk enkripsi default**, Anda harus mengonfigurasi pengaturan enkripsi berikut.
+ Untuk mengenkripsi file yang diunggah dengan menggunakan kunci yang dikelola oleh Amazon S3, pilih **Kunci yang dikelola Amazon S3 (SSE-S3)**.
Untuk informasi selengkapnya, lihat [Menggunakan enkripsi di sisi server dengan kunci terkelola Amazon S3 (SSE-S3)](UsingServerSideEncryption.md).
+ 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**). Lalu pilih salah satu opsi berikut ini untuk **kunci AWS KMS **:
+ Untuk memilih dari daftar kunci KMS yang tersedia, pilih **Pilih dari AWS KMS keys Anda**, dan pilih **Kunci KMS** Anda dari daftar kunci yang tersedia.
Kunci Kunci yang dikelola AWS (`aws/s3`) dan kunci terkelola pelanggan Anda muncul dalam daftar ini. Untuk informasi selengkapnya tentang CMK, lihat [Kunci pelanggan dan AWS kunci](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#key-mgmt) di *AWS Key Management Service Panduan Pengembang*.
+ Untuk memasukkan ARN kunci KMS, pilih **Masukkan AWS KMS key ARN**, lalu masukkan ARN kunci KMS Anda di bidang yang muncul.
+ Untuk membuat kunci terkelola pelanggan baru di AWS KMS konsol, pilih **Buat kunci KMS**.
Untuk informasi selengkapnya tentang membuat AWS KMS key, lihat [Membuat kunci](https://docs.aws.amazon.com//kms/latest/developerguide/create-keys.html) di *Panduan AWS Key Management Service Pengembang*.
**penting**
Anda hanya dapat menggunakan tombol KMS yang tersedia Wilayah AWS sama dengan bucket. Konsol Amazon S3 hanya mencantumkan kunci 100 KMS pertama di Wilayah yang sama dengan bucket. Untuk menggunakan kunci KMS yang tidak terdaftar, Anda harus memasukkan ARN kunci KMS Anda. Jika Anda ingin menggunakan kunci KMS yang dimiliki oleh akun lain, Anda harus terlebih dahulu memiliki izin untuk menggunakan kunci tersebut, dan kemudian Anda harus memasukkan ARN kunci KMS.
Amazon S3 hanya mendukung kunci KMS enkripsi simetris, dan tidak mendukung kunci KMS asimetris. Untuk informasi selengkapnya, lihat [Mengidentifikasi tombol KMS simetris dan asimetris](https://docs.aws.amazon.com//kms/latest/developerguide/find-symm-asymm.html) dalam *Panduan Pengembang AWS Key Management Service *.
1. 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 di Amazon S3](checking-object-integrity.md).
1. 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 [Mengkategorikan objek Anda menggunakan tag](object-tagging.md).
1. Untuk menambahkan metadata, pilih **Tambahkan metadata**.
1. Di bawah **Jenis**, pilih **Ditentukan sistem** atau **Ditentukan pengguna**.
Untuk metadata yang ditentukan sistem, Anda dapat memilih header HTTP umum, seperti **Jenis Konten** dan **Konten-Disposisi**. Untuk daftar metadata yang ditentukan sistem, serta informasi tentang apakah Anda dapat menambahkan nilai, lihat [Metadata objek yang ditentukan sistem](UsingMetadata.md#SysMetadata). 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 nilainya harus sesuai dengan standar US-ASCII. 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](UsingMetadata.md).
1. Untuk **Kunci**, pilih kuncinya.
1. Ketikkan nilai untuk kunci tersebut.
1. Untuk mengunggah objek Anda, pilih **Unggah**.
Amazon S3 mengunggah objek Anda. Setelah unggahannya selesai, Anda dapat melihat pesan sukses di halaman **Unggah: status**.
1. Pilih **Keluar**.
### Menggunakan AWS CLI
Anda dapat mengirim permintaan `PUT` untuk mengunggah objek hingga 5 GB dalam satu operasi. Untuk informasi dan contoh selengkapnya, lihat contoh [https://docs.aws.amazon.com/cli/latest/reference/s3api/put-object.html#examples](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-object.html#examples) di *AWS CLI Referensi Perintah*.
### Penggunaan API REST
Anda dapat mengirim permintaan REST untuk mengunggah sebuah objek. Anda dapat mengirim permintaan `PUT` untuk mengunggah dalam satu operasi. Untuk informasi lebih lanjut, lihat [PUT Objek](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html).
### Menggunakan AWS SDKs
Untuk contoh cara mengunggah objek dengan AWS SDKs, lihat [Contoh Kode](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObject_section.html) di *Referensi API Amazon Simple Storage Service*.
Untuk informasi umum tentang penggunaan yang berbeda AWS SDKs, lihat [Mengembangkan dengan Amazon S3 menggunakan AWS SDKs Referensi](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) *API Layanan Penyimpanan Sederhana Amazon*.
## 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 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)atau [CompleteMultipartUpload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)permintaan.
Untuk informasi selengkapnya tentang permintaan bersyarat, lihat,[Tambahkan prasyarat ke operasi S3 dengan permintaan bersyarat](conditional-requests.md).