Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengunggah objek
Bagian ini menjelaskan cara untuk mengunduh objek dari bucket Amazon S3. Dengan Amazon S3, Anda dapat menyimpan objek dalam satu atau lebih ember, dan setiap objek dapat berukuran hingga 50 TB. Objek Amazon S3 apa pun yang tidak diarsipkan dapat diakses secara real time. Namun, objek yang diarsipkan harus dipulihkan sebelum dapat diunduh. Untuk informasi tentang objek yang diarsipkan, lihat [Mengunduh objek yang diarsipkan](#download-archived-objects).
Anda dapat mengunduh satu objek dengan menggunakan konsol Amazon S3, AWS Command Line Interface (AWS CLI) AWS SDKs, atau Amazon S3 REST API. Untuk mengunduh objek hingga 5 TB dari S3 tanpa menulis kode apa pun atau menjalankan perintah apa pun, gunakan konsol S3. Untuk informasi selengkapnya, lihat [Mengunduh objek](#download-an-object).
Untuk mengunduh objek yang lebih besar dari 5 TB, gunakan `GetObject` permintaan bersamaan dengan header `Range` HTTP untuk membaca rentang byte tertentu atau `partNumber` untuk mengunduh bagian tertentu dari suatu objek. Permintaan GET tunggal dibatasi hingga 5 TB, dan Anda akan menerima `405 - Method Not Allowed` kesalahan untuk permintaan GET melebihi 5 TB.
Untuk unduhan objek besar, 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. CRT secara otomatis menskalakan ukuran individu GETs untuk mengoptimalkan throughput. Anda dapat meningkatkan throughput transfer secara keseluruhan dengan mengalokasikan lebih banyak memori menggunakan parameter batas memori seperti `maxNativeMemoryLimitInBytes` untuk Java SDK. Anda dapat memilih keluar dari perilaku ini dengan menyetel ukuran bagian eksplisit menggunakan parameter permintaan seperti `multipart_chunksize` untuk AWS CLI dan `minimumPartSizeInBytes` untuk Java SDK dalam permintaan unduhan Anda.
Untuk mengunduh beberapa objek AWS CloudShell, gunakan AWS CLI, atau file AWS SDKs. Untuk informasi selengkapnya, lihat [Mengunduh beberapa objek](#download-multiple-objects).
Jika Anda perlu mengunduh bagian dari suatu objek, Anda menggunakan parameter tambahan dengan AWS CLI atau REST API untuk menentukan hanya byte yang ingin Anda unduh. Untuk informasi selengkapnya, lihat [Mengunduh bagian dari suatu objek](#download-objects-parts).
Jika Anda perlu mengunduh objek yang bukan milik Anda, mintalah pemilik objek untuk membuat URL yang telah ditentukan sebelumnya yang memungkinkan Anda mengunduh objek tersebut. Untuk informasi selengkapnya, lihat [Mengunduh objek dari yang lain Akun AWS](#download-objects-from-another-account).
Saat Anda mengunduh objek di luar AWS jaringan, biaya transfer data berlaku. Transfer data dalam AWS jaringan gratis dalam hal yang sama Wilayah AWS, tetapi Anda akan dikenakan biaya untuk `GET` permintaan apa pun. Untuk informasi selengkapnya tentang biaya transfer data dan pengambilan data, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
**Topics**
+ [Mengunduh objek](#download-an-object)
+ [Mengunduh beberapa objek](#download-multiple-objects)
+ [Mengunduh bagian dari suatu objek](#download-objects-parts)
+ [Mengunduh objek dari yang lain Akun AWS](#download-objects-from-another-account)
+ [Mengunduh objek yang diarsipkan](#download-archived-objects)
+ [Mengunduh objek berdasarkan metadata](#download-objects-based-on-metadata)
+ [Memecahkan masalah pengunduhan objek](#download-objects-troubleshooting)
## Mengunduh objek
Anda dapat mengunduh objek dengan menggunakan konsol Amazon S3, AWS CLI AWS SDKs, atau REST API.
### Menggunakan konsol S3
Bagian ini menjelaskan cara menggunakan konsol Amazon S3 untuk mengunduh objek dari bucket S3.
**catatan**
Anda hanya dapat mengunduh satu objek dalam satu waktu.
Jika Anda menggunakan konsol Amazon S3 untuk mengunduh objek yang nama kuncinya diakhiri dengan titik (`.`), titik tersebut dihapus dari nama kunci objek yang diunduh. Untuk mempertahankan periode di akhir nama objek yang diunduh, Anda harus menggunakan AWS Command Line Interface (AWS CLI) AWS SDKs, atau Amazon S3 REST API.
**Untuk mengunduh objek dari 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 **tujuan umum atau ember** **Direktori**.
1. Dalam daftar bucket, pilih nama bucket tempat Anda ingin mengunduh objek.
1. Anda dapat mengunduh objek dari bucket S3 dengan cara berikut:
+ Pilih kotak centang di samping objek, dan pilih **Unduh**. Jika Anda ingin mengunduh objek ke folder tertentu, pada menu **Tindakan**, pilih **Unduh sebagai**.
+ Jika Anda ingin mengunduh versi objek tertentu, aktifkan **Tampilkan versi** (terletak di samping kotak pencarian). Centang kotak di samping versi objek yang Anda inginkan, dan pilih **Unduh**. Jika Anda ingin mengunduh objek ke folder tertentu, pada menu **Tindakan**, pilih **Unduh sebagai**.
### Menggunakan AWS CLI
Contoh perintah `get-object` berikut menunjukkan bagaimana Anda dapat menggunakan AWS CLI untuk mengunduh objek dari Amazon S3. Perintah ini mendapatkan objek `folder/my_image` dari bucket `amzn-s3-demo-bucket1`. Anda harus menyertakan`outfile`, yang merupakan nama file untuk objek yang diunduh, seperti`my_downloaded_image.jpg`.
```
aws s3api get-object --bucket amzn-s3-demo-bucket1 --key folder/my_image my_downloaded_image.jpg
```
Untuk informasi dan contoh selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html) di *AWS CLI Referensi Perintah*.
### Menggunakan AWS SDKs
Untuk contoh cara mengunduh objek dengan AWS SDKs, lihat [Contoh kode](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObject_section.html) di Referensi *API Amazon S3*.
Untuk informasi umum tentang penggunaan yang berbeda AWS SDKs, lihat [Mengembangkan dengan Amazon S3 menggunakan](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) Referensi API Amazon *S3 AWS SDKs di Amazon S3*.
### Penggunaan API REST
Anda dapat menggunakan API REST untuk mengambil objek dari Amazon S3. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) dalam *Referensi API Amazon Simple Storage Service*.
## Mengunduh beberapa objek
Anda dapat mengunduh beberapa objek dengan menggunakan AWS CloudShell, file AWS CLI, atau file AWS SDKs.
### Menggunakan AWS CloudShell di Konsol Manajemen AWS
AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. Konsol Manajemen AWS
Untuk informasi lebih lanjut tentang AWS CloudShell, lihat [Apa itu CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) dalam *AWS CloudShell User Guide*.
**penting**
Dengan AWS CloudShell, direktori home Anda memiliki penyimpanan hingga 1GB per Wilayah AWS. Maka, Anda tidak dapat menyinkronkan bucket dengan objek yang berjumlah lebih dari jumlah ini. Untuk pembatasan yang lebih lengkap, lihat [Kuota layanan dan batasan](https://docs.aws.amazon.com/cloudshell/latest/userguide/limits.html) di *AWS CloudShell Panduan Pengguna*.
**Untuk mengunduh objek dengan menggunakan AWS CloudShell**
1. Masuk ke Konsol Manajemen AWS dan buka CloudShell konsol di [https://console.aws.amazon.com/cloudshell/](https://console.aws.amazon.com/cloudshell/).
1. Jalankan perintah berikut untuk menyinkronkan objek di bucket Anda CloudShell. Perintah berikut menyinkronkan objek dari bucket bernama `amzn-s3-demo-bucket1` dan membuat folder bernama`temp`. CloudShell CloudShell menyinkronkan objek Anda ke folder ini. Untuk menggunakan perintah ini, ganti `user input placeholders` dengan informasi Anda sendiri.
```
aws s3 sync s3://amzn-s3-demo-bucket1 ./temp
```
**catatan**
`sync`Perintah ini tidak kompatibel dengan bucket direktori.
Untuk melakukan pencocokan pola untuk mengecualikan atau menyertakan objek tertentu, Anda dapat menggunakan parameter `--exclude "value"` dan `--include "value"` dengan perintah `sync`.
1. Jalankan perintah berikut untuk meng-zip objek Anda di folder bernama `temp` ke file bernama `temp.zip`.
```
zip temp.zip -r temp/
```
1. Pilih **Tindakan**, lalu pilih **Unduh file**.
1. Masukkan nama file `temp.zip` lalu pilih **Unduh**.
1. (Opsional) Hapus `temp.zip` file dan objek yang disinkronkan ke `temp` folder di CloudShell. Dengan AWS CloudShell, Anda memiliki penyimpanan persisten hingga 1 GB untuk masing-masing Wilayah AWS.
Anda dapat menggunakan contoh perintah berikut untuk menghapus file `.zip` dan folder Anda. Untuk menggunakan contoh perintah ini, ganti `user input placeholders` dengan informasi Anda sendiri.
```
rm temp.zip && rm -rf temp/
```
### Menggunakan AWS CLI
Contoh berikut menunjukkan bagaimana Anda dapat menggunakan AWS CLI untuk men-download semua file atau objek di bawah direktori tertentu atau awalan. Perintah ini menyalin semua objek dari bucket `amzn-s3-demo-bucket1` ke direktori Anda saat ini. Untuk menggunakan perintah contoh ini, gunakan nama bucket Anda sebagai pengganti `amzn-s3-demo-bucket1`.
```
aws s3 cp s3://amzn-s3-demo-bucket1 . --recursive
```
Perintah berikut mengunduh semua objek di bawah prefiks `logs` di bucket `amzn-s3-demo-bucket1` ke direktori Anda saat ini. Ini juga menggunakan parameter `--exclude` dan `--include` untuk menyalin hanya objek dengan sufiks `.log`. Untuk menggunakan contoh perintah ini, ganti `user input placeholders` dengan informasi Anda sendiri.
```
aws s3 cp s3://amzn-s3-demo-bucket1/logs/ . --recursive --exclude "*" --include "*.log"
```
Untuk informasi dan contoh selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html) di *AWS CLI Referensi Perintah*.
### Menggunakan AWS SDKs
Untuk contoh cara mengunduh semua objek di bucket Amazon S3 dengan AWS SDKs, lihat [Contoh kode](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_DownloadBucketToDirectory_section.html) di Referensi API *Amazon S3*.
Untuk informasi umum tentang penggunaan yang berbeda AWS SDKs, lihat [Mengembangkan dengan Amazon S3 menggunakan](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) Referensi API Amazon *S3 AWS SDKs di Amazon S3*.
## Mengunduh bagian dari suatu objek
Anda dapat mengunduh bagian dari suatu objek dengan menggunakan AWS CLI atau REST API. Untuk melakukannya, Anda menggunakan parameter tambahan untuk menentukan bagian mana dari objek yang ingin Anda unduh.
### Menggunakan AWS CLI
Perintah contoh berikut ini melakukan permintaan `GET` untuk rentang byte dalam objek bernama `folder/my_data` dalam bucket yang bernama `amzn-s3-demo-bucket1`. Dalam permintaan tersebut, rentang byte harus diawali dengan `bytes=`. Objek parsial diunduh ke file output bernama `my_data_range`. Untuk menggunakan contoh perintah ini, ganti `user input placeholders` dengan informasi Anda sendiri.
```
aws s3api get-object --bucket amzn-s3-demo-bucket1 --key folder/my_data --range bytes=0-500 my_data_range
```
Untuk informasi dan contoh selengkapnya, lihat [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html) di *AWS CLI Referensi Perintah*.
Untuk informasi selengkapnya tentang header `Range` HTTP, lihat [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-range) di situs web RFC Editor.
**catatan**
Amazon S3 tidak mendukung pengambilan beberapa rentang data dalam satu permintaan `GET`.
### Penggunaan API REST
Anda dapat menggunakan parameter `partNumber` dan `Range` di API REST untuk mengambil bagian objek dari Amazon S3. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) dalam *Referensi API Amazon Simple Storage Service*.
## Mengunduh objek dari yang lain Akun AWS
Anda dapat menggunakan URL yang telah ditandatangani sebelumnya untuk memberi orang lain akses yang dibatasi waktu ke objek Anda tanpa memperbarui kebijakan bucket Anda.
URL yang telah ditandatangani sebelumnya dapat dimasukkan di dalam browser, atau digunakan oleh program untuk mengunduh objek. Kredensi yang digunakan oleh URL adalah milik AWS pengguna yang membuat URL. Setelah URL dibuat, siapa pun yang memiliki URL yang telah ditentukan sebelumnya dapat mengunduh objek terkait hingga URL tersebut kedaluwarsa.
### Menggunakan URL yang telah ditandatangani sebelumnya di konsol S3
Anda dapat menggunakan konsol Amazon S3 untuk membuat URL yang telah ditetapkan sebelumnya untuk berbagi objek dalam bucket tujuan umum dengan mengikuti langkah-langkah berikut. Saat menggunakan konsol, waktu kedaluwarsa maksimum untuk URL yang telah ditandatangani sebelumnya adalah 12 jam dari waktu pembuatan.
**Untuk menghasilkan URL yang telah ditandatangani sebelumnya menggunakan konsol Amazon 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 tujuan umum**.
1. Dalam daftar bucket, pilih nama bucket yang berisi objek yang Anda inginkan sebagai URL presigned.
1. Dalam daftar **Objek**, pilih objek yang ingin Anda buatkan URL yang telah ditandatangani.
1. Pada menu **Tindakan objek**, pilih **Bagikan dengan URL yang telah ditandatangani**.
1. Tentukan berapa lama Anda menginginkan URL yang telah ditandatangani tersebut valid.
1. Pilih **Buat URL yang telah ditandatangani**.
1. Ketika pesan konfirmasi muncul, URL secara otomatis disalin ke clipboard Anda. Anda akan melihat tombol untuk menyalin URL yang telah ditandatangani jika Anda perlu menyalinnya lagi.
1. Untuk mengunduh objek, tempel URL ke browser apa pun, dan objek akan mencoba mengunduh.
Untuk informasi selengkapnya tentang presigned URLs dan metode lain untuk membuatnya, lihat[Unduh dan unggah objek dengan presigned URLs](using-presigned-url.md).
## Mengunduh objek yang diarsipkan
Untuk mengurangi biaya penyimpanan objek yang jarang diakses, Anda dapat *mengarsipkan* objek tersebut. Ketika Anda mengarsipkan objek, objek tersebut dipindahkan ke penyimpanan berbiaya rendah, yang berarti Anda tidak dapat mengaksesnya secara real time. Untuk mengunduh objek yang diarsipkan, Anda harus memulihkannya terlebih dahulu.
Anda dapat memulihkan objek yang diarsipkan dalam hitungan menit atau jam, tergantung pada kelas penyimpanan. Anda dapat memulihkan objek yang diarsipkan menggunakan konsol Amazon S3, Operasi Batch S3, API REST Amazon S3, AWS SDKs the, dan (). AWS Command Line Interface AWS CLI
Untuk petunjuk, lihat [Memulihkan objek yang diarsipkan](restoring-objects.md). Setelah Anda memulihkan objek yang diarsipkan, Anda dapat mengunduhnya.
## Mengunduh objek berdasarkan metadata
Anda dapat menambahkan prasyarat untuk mengunduh objek berdasarkan metadatanya menggunakan permintaan baca bersyarat. Anda dapat mengembalikan objek berdasarkan tag Entity (ETag) atau tanggal modifikasi terakhir. Ini dapat membatasi operasi S3 ke objek yang diperbarui sejak tanggal tertentu atau hanya mengembalikan versi objek tertentu.
Anda dapat menggunakan penulisan bersyarat untuk [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)atau [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)permintaan.
Untuk informasi selengkapnya tentang permintaan bersyarat, lihat,[Tambahkan prasyarat ke operasi S3 dengan permintaan bersyarat](conditional-requests.md).
## Memecahkan masalah pengunduhan objek
Izin yang tidak memadai atau kebijakan pengguna bucket atau AWS Identity and Access Management (IAM) yang salah dapat menyebabkan kesalahan saat Anda mencoba mengunduh objek dari Amazon S3. Masalah ini sering dapat menyebabkan kesalahan Akses Ditolak (403 Dilarang). di mana Amazon S3 tidak bisa memberikan akses ke sumber daya.
Untuk mengetahui penyebab umum kesalahan Akses Ditolak (403 Forbidden), lihat [Memecahkan masalah kesalahan akses ditolak (403 Forbidden) di Amazon S3](troubleshoot-403-errors.md).
Jika Anda mendapatkan NoSuchKey kesalahan 404 saat mencoba mengakses objek, lihat [Bagaimana saya bisa memecahkan masalah kesalahan 404 dari NoSuchKey Amazon](https://repost.aws/knowledge-center/404-error-nosuchkey-s3) S3? di pusat AWS re:Post pengetahuan.