Mengunggah objek

Bagian ini menjelaskan cara untuk mengunduh objek dari bucket Amazon S3. Dengan Amazon S3, Anda dapat menyimpan objek dalam satu atau lebih bucket, dan setiap objek dapat berukuran hingga 5 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.

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 dari S3 tanpa menulis kode atau menjalankan perintah apa pun, gunakan konsol S3. Untuk informasi selengkapnya, lihat Mengunduh objek.

Untuk mengunduh beberapa objek AWS CloudShell, gunakan AWS CLI, atau file AWS SDKs. Untuk informasi selengkapnya, lihat Mengunduh beberapa objek.

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.

Jika Anda perlu mengunduh objek yang tidak Anda miliki, minta pemilik objek untuk menghasilkan presigned URL yang memungkinkan Anda mengunduh objek. Untuk informasi selengkapnya, lihat Mengunduh objek dari Akun AWS yang lain.

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.

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 RESTAPI.

Untuk mengunduh objek dari bucket S3

1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

2. Di dalam daftar Bucket, pilih nama bucket yang ingin Anda unduh objeknya.

3. 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. Objek akan diunduh ke file yang bernama my_downloaded_image.

aws s3api get-object --bucket amzn-s3-demo-bucket1 --key folder/my_image my_downloaded_image

Untuk informasi dan contoh selengkapnya, lihat get-objectdalam AWS CLI Command Reference.

Menggunakan AWS SDKs

Untuk contoh cara mengunduh objek dengan AWS SDKs, lihat Contoh kode di Referensi Amazon S3 API.

Untuk informasi umum tentang penggunaan yang berbeda AWS SDKs, lihat Mengembangkan dengan Amazon S3 menggunakan Referensi Amazon S3 AWS SDKs di Amazon API S3.

Menggunakan REST API

Anda dapat menggunakan REST API untuk mengambil objek dari Amazon S3. Untuk informasi selengkapnya, silakan lihat GetObjectdi APIReferensi Layanan Penyimpanan Sederhana Amazon.

Mengunduh beberapa objek

Anda dapat mengunduh beberapa objek dengan menggunakan AWS CloudShell, file AWS CLI, atau file AWS SDKs.

Menggunakan AWS CloudShell di AWS Management Console

AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. AWS Management Console

Untuk informasi lebih lanjut tentang AWS CloudShell, lihat Apa itu CloudShell? 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 di AWS CloudShell Panduan Pengguna.

Untuk mengunduh objek dengan menggunakan AWS CloudShell

1. Masuk ke AWS Management Console dan buka CloudShell konsol di https://console.aws.amazon.com/cloudshell/.

2. Jalankan perintah berikut untuk menyinkronkan objek di bucket Anda CloudShell. Perintah berikut menyinkronkan objek dari bucket bernama amzn-s3-demo-bucket1 dan membuat folder bernamatemp. 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

   Untuk melakukan pencocokan pola untuk mengecualikan atau menyertakan objek tertentu, Anda dapat menggunakan parameter --exclude "value" dan --include "value" dengan perintah sync.

3. Jalankan perintah berikut untuk meng-zip objek Anda di folder bernama temp ke file bernama temp.zip.

   zip temp.zip -r temp/

4. Pilih Tindakan, lalu pilih Unduh file.

5. Masukkan nama file temp.zip lalu pilih Unduh.

6. (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 cpdalam AWS CLI Command Reference.

Menggunakan AWS SDKs

Untuk contoh cara mengunduh semua objek di bucket Amazon S3 dengan AWS SDKs, lihat Contoh kode di Referensi Amazon API S3.

Untuk informasi umum tentang penggunaan yang berbeda AWS SDKs, lihat Mengembangkan dengan Amazon S3 menggunakan Referensi Amazon S3 AWS SDKs di Amazon API S3.

Mengunduh bagian dari suatu objek

Anda dapat mengunduh bagian dari suatu objek dengan menggunakan AWS CLI atau RESTAPI. 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 get-objectdalam AWS CLI Command Reference.

Untuk informasi lebih lanjut tentang HTTP Range header, lihat RFC9110 di situs web RFC Editor.

catatan

Amazon S3 tidak mendukung pengambilan beberapa rentang data dalam satu permintaan GET.

Menggunakan REST API

Anda dapat menggunakan partNumber dan Range parameter dalam REST API untuk mengambil bagian objek dari Amazon S3. Untuk informasi selengkapnya, silakan lihat GetObjectdi APIReferensi Layanan Penyimpanan Sederhana Amazon.

Mengunduh objek dari Akun AWS yang lain

Anda dapat menggunakan presigned URL untuk memberi orang lain akses terbatas waktu ke objek Anda tanpa memperbarui kebijakan bucket Anda.

Presigned URL dapat dimasukkan dalam browser atau digunakan oleh program untuk mengunduh objek. Kredensi yang digunakan oleh URL adalah milik AWS pengguna yang menghasilkan file. URL Setelah URL dibuat, siapa pun dengan presigned URL dapat mengunduh objek yang sesuai hingga URL kedaluwarsa.

Menggunakan presigned URL di konsol S3

Anda dapat menggunakan konsol Amazon S3 untuk membuat presigned URL untuk berbagi objek dengan mengikuti langkah-langkah ini. Saat menggunakan konsol, waktu kedaluwarsa maksimum untuk presigned URL adalah 12 jam dari waktu pembuatan.

Untuk menghasilkan presigned URL dengan menggunakan konsol Amazon S3

1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

2. Di panel navigasi kiri, pilih Bucket.

3. Dalam daftar Bucket, pilih nama bucket yang berisi objek yang ingin Anda tetapkan sebelumnya. URL

4. Dalam daftar Objek, pilih objek yang ingin Anda buat presigned URL untuk.

5. Pada menu Tindakan objek, pilih Bagikan dengan presigned URL.

6. Tentukan berapa lama Anda ingin presigned URL valid.

7. Pilih Buat presigned URL.

8. Ketika pesan konfirmasi muncul, pesan tersebut secara otomatis URL disalin ke clipboard Anda. Anda akan melihat tombol untuk menyalin presigned URL jika Anda perlu menyalinnya lagi.

9. Untuk mengunduh objek, tempelkan URL ke browser apa pun, dan objek akan mencoba mengunduh.

Untuk informasi selengkapnya tentang presigned URLs dan metode lain untuk membuatnya, lihatUnduh dan unggah objek dengan presigned URLs.

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, Amazon REST API S3, AWS SDKs the, dan (). AWS Command Line Interface AWS CLI

Untuk petunjuk, silakan lihat Memulihkan objek yang diarsipkan. 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 GetObject atau HeadObjectpermintaan.

Untuk informasi selengkapnya tentang permintaan bersyarat, lihat,Tambahkan prasyarat ke operasi S3 dengan permintaan bersyarat.

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 akses ditolak (403 Forbidden) kesalahan di Amazon S3.