Mengunggah objek - Amazon Simple Storage Service

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

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 AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

  2. Di panel navigasi kiri, pilih Bucket tujuan umum atau ember Direktori.

  3. Dalam daftar bucket, pilih nama bucket tempat Anda ingin mengunduh objek.

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

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 menyertakanoutfile, yang merupakan nama file untuk objek yang diunduh, sepertimy_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 get-objectpada AWS CLI Command Reference.

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

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

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

Mengunduh beberapa objek

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

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

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

  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/

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 cppada AWS CLI Command Reference.

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

Untuk informasi umum tentang penggunaan yang berbeda AWS SDKs, lihat Mengembangkan dengan Amazon S3 menggunakan 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.

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-objectpada AWS CLI Command Reference.

Untuk informasi selengkapnya tentang header Range HTTP, lihat RFC 9110 di situs web RFC Editor.

catatan

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

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

Mengunduh objek dari Akun AWS yang lain

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.

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 AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

  2. Di panel navigasi kiri, pilih Bucket tujuan umum.

  3. Dalam daftar bucket, pilih nama bucket yang berisi objek yang Anda inginkan untuk URL yang telah ditetapkan sebelumnya.

  4. Dalam daftar Objek, pilih objek yang ingin Anda buatkan URL yang telah ditandatangani.

  5. Pada menu Tindakan objek, pilih Bagikan dengan URL yang telah ditandatangani.

  6. Tentukan berapa lama Anda menginginkan URL yang telah ditandatangani tersebut valid.

  7. Pilih Buat URL yang telah ditandatangani.

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

  9. 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, 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, API REST Amazon 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.