Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menyalin, memindahkan, dan mengganti nama objek
CopyObject
Operasi membuat salinan objek yang sudah disimpan di Amazon S3.
Anda dapat membuat salinan objek hingga 5 GB dalam satu operasi atom. Namun, untuk menyalin objek yang lebih besar dari 5 GB, Anda harus menggunakan unggahan multipart menggunakan AWS CLI or AWS SDKs. Untuk informasi selengkapnya, lihat Menyalin objek menggunakan unggahan multibagian.
Dengan menggunakan operasi CopyObject
, Anda dapat:
-
Buat salinan objek tambahan.
-
Ganti nama objek dengan menyalinnya dan menghapus yang asli.
-
Salin atau pindahkan objek dari satu ember ke ember lainnya, termasuk melintasi Wilayah AWS (misalnya, dari
us-west-1
keeu-west-2
). Saat Anda memindahkan objek, Amazon S3 menyalin objek ke tujuan yang ditentukan dan kemudian menghapus objek sumber.catatan
Menyalin atau memindahkan objek di seluruh Wilayah AWS menimbulkan biaya bandwidth. Untuk informasi selengkapnya, lihat harga Amazon S3
. -
Ubah metadata objek. Setiap objek Amazon S3 memiliki metadata. Metadata ini adalah satu set pasangan nama-nilai. Anda dapat mengatur metadata objek pada saat Anda mengunggah objek. Setelah Anda mengunggah objek, Anda tidak dapat mengubah metadata objek. Satu-satunya cara untuk memodifikasi metadata objek adalah membuat salinan objek, dan mengatur metadatanya. Untuk melakukannya, dalam operasi penyalinan, atur objek yang sama dengan sumber dan target.
Beberapa metadata objek adalah metadata sistem dan lainnya ditentukan pengguna. Anda dapat mengontrol beberapa metadata sistem. Misalnya, Anda dapat mengontrol kelas penyimpanan dan jenis enkripsi sisi server yang akan digunakan untuk objek. Saat Anda menyalin sebuah objek, metadata sistem yang dikontrol pengguna dan metadata yang ditentukan pengguna juga disalin. Amazon S3 mengatur ulang metadata yang dikontrol sistem. Misalnya, saat Anda menyalin suatu objek, Amazon S3 mengatur ulang tanggal penciptaan objek yang disalin. Anda tidak perlu menyetel salah satu nilai metadata yang dikendalikan sistem ini dalam permintaan salinan Anda.
Saat menyalin sebuah objek, Anda mungkin memutuskan untuk memperbarui beberapa nilai metadata. Misalnya, jika objek sumber Anda dikonfigurasi untuk menggunakan penyimpanan Standar S3, Anda dapat memilih untuk menggunakan S3 Intelligent-Tiering untuk salinan objek tersebut. Anda juga dapat memutuskan untuk mengubah beberapa nilai metadata yang ditentukan pengguna yang terdapat pada objek sumber tersebut. Jika Anda memilih untuk memperbarui salah satu metadata objek yang dapat dikonfigurasi pengguna (sistem atau yang ditentukan pengguna) selama penyalinan, maka Anda harus secara eksplisit menentukan semua metadata yang dapat dikonfigurasi pengguna yang ada pada objek sumber dalam permintaan Anda, bahkan jika Anda mengubahnya hanya satu dari nilai metadata.
Untuk informasi selengkapnya tentang metadata objek, lihat Bekerja dengan metadata objek.
Menyalin objek yang diarsipkan dan dipulihkan
Jika objek sumber diarsipkan di S3 Glacier Flexible Retrieval atau S3 Glacier Deep Archive, Anda harus memulihkan salinan sementara terlebih dahulu sebelum dapat menyalin objek ke bucket lain. Untuk informasi tentang pengarsipan objek, lihat Bekerja dengan objek yang diarsipkan.
Operasi Salin di konsol Amazon S3 tidak didukung untuk objek yang dipulihkan di kelas penyimpanan S3 Glacier Flexible Retrieval atau S3 Glacier Deep Archive. Untuk menyalin objek yang dipulihkan ini, gunakan AWS Command Line Interface (AWS CLI), the AWS SDKs, atau Amazon S3 RESTAPI.
Menyalin objek terenkripsi
Amazon S3 secara otomatis mengenkripsi semua objek baru yang disalin ke bucket S3. Jika Anda tidak menentukan informasi enkripsi dalam permintaan penyalinan, pengaturan enkripsi objek target diatur ke konfigurasi enkripsi default bucket tujuan. Secara default, semua bucket memiliki tingkat dasar konfigurasi enkripsi yang menggunakan enkripsi sisi server dengan kunci terkelola Amazon S3 (-S3). SSE Jika bucket tujuan memiliki konfigurasi enkripsi default yang menggunakan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS) (SSE-), atau kunci enkripsi (-CKMS) yang disediakan pelanggan, Amazon S3 menggunakan kunci yang KMS sesuai, atau kunci yang disediakan pelanggan untuk mengenkripsi salinan objek target. SSE
Saat menyalin objek, jika Anda ingin menggunakan jenis pengaturan enkripsi yang berbeda untuk objek target, Anda dapat meminta Amazon S3 mengenkripsi objek target dengan KMS kunci, kunci terkelola Amazon S3, atau kunci yang disediakan pelanggan. Jika pengaturan enkripsi dalam permintaan Anda berbeda dari konfigurasi enkripsi default bucket tujuan, pengaturan enkripsi dalam permintaan Anda akan lebih diutamakan. Jika objek sumber untuk salinan dienkripsi dengan SSE -C, Anda harus memberikan informasi enkripsi yang diperlukan dalam permintaan Anda sehingga Amazon S3 dapat mendekripsi objek untuk disalin. Untuk informasi selengkapnya, lihat Melindungi data dengan enkripsi.
Menggunakan checksum saat menyalin objek
Saat menyalin objek, Anda dapat memilih untuk menggunakan algoritma checksum yang berbeda untuk objek tersebut. Apakah Anda memilih untuk menggunakan algoritma yang sama atau yang baru, Amazon S3 menghitung nilai checksum baru setelah objek disalin. Amazon S3 tidak secara langsung menyalin nilai checksum. Nilai checksum objek yang dimuat dengan menggunakan unggahan multipart mungkin berubah. Untuk informasi selengkapnya tentang bagaimana checksum dihitung, lihat Menggunakan checksum tingkat bagian untuk unggahan multibagian.
Menyalin beberapa objek dalam satu permintaan
Untuk menyalin lebih dari satu objek Amazon S3 dengan satu permintaan, Anda juga dapat menggunakan Operasi Batch S3. Anda menyediakan daftar objek yang akan dioperasikan kepada Operasi Batch S3. Operasi Batch S3 memanggil API operasi masing-masing untuk melakukan operasi yang ditentukan. Satu tugas Operasi Batch dapat melakukan operasi tertentu pada miliaran objek yang berisi data sebesar eksabita.
Operasi Batch S3 memiliki fitur melacak progres, mengirimkan notifikasi, dan menyimpan laporan penyelesaian terperinci dari semua tindakan, menyediakan pengalaman yang dikelola sepenuhnya, dapat diaudit, dan nirserver. Anda dapat menggunakan Operasi Batch S3 melalui konsol Amazon S3 AWS CLI,, AWS SDKs, atau. REST API Untuk informasi selengkapnya, lihat Dasar-dasar Operasi Batch S3.
Menyalin objek ke ember direktori
Untuk informasi tentang menyalin objek ke bucket direktori, lihatMenyalin objek dari atau ke ember direktori. Untuk informasi tentang menggunakan kelas penyimpanan Amazon S3 Express One Zone dengan bucket direktori, lihat dan. S3 Express One Zone Bekerja dengan bucket direktori
Untuk menyalin objek
Untuk menyalin objek, gunakan metode berikut.
catatan
Batasan dan batasan saat Anda menyalin objek dengan konsol adalah sebagai berikut:
-
Anda dapat menyalin objek jika objek Anda kurang dari 5 GB. Jika objek Anda lebih besar dari 5 GB, Anda harus menggunakan AWS CLIatau AWS SDKsuntuk menyalin objek.
-
Untuk daftar izin tambahan yang diperlukan untuk menyalin objek, lihatIzin yang diperlukan untuk operasi Amazon API S3. Misalnya kebijakan yang memberikan izin ini, lihatContoh kebijakan berbasis identitas untuk Amazon S3.
-
Copy
Tindakan ini berlaku untuk semua objek dalam folder yang ditentukan (awalan). Objek yang ditambahkan ke folder ini saat tindakan sedang berlangsung mungkin terpengaruh. -
Penyalinan lintas Wilayah objek yang dienkripsi dengan SSE - tidak KMS didukung oleh konsol Amazon S3. Untuk menyalin objek yang dienkripsi dengan SSE - KMS di seluruh Wilayah, gunakan AWS CLI, AWS SDK, atau Amazon S3. REST API
-
Objek yang dienkripsi dengan kunci enkripsi yang disediakan pelanggan (SSE-C) tidak dapat disalin dengan menggunakan konsol S3. Untuk menyalin objek yang dienkripsi dengan SSE -C, gunakan, AWS CLI AWS SDK, atau Amazon S3. REST API
-
Objek yang disalin tidak akan mempertahankan pengaturan Object Lock dari objek asli.
-
Jika bucket tempat Anda menyalin objek menggunakan pengaturan yang diberlakukan pemilik bucket untuk Kepemilikan Objek S3, objek tidak ACLs akan disalin ke tujuan yang ditentukan.
-
Jika Anda ingin menyalin objek ke bucket yang menggunakan setelan diberlakukan pemilik bucket untuk Kepemilikan Objek S3, pastikan bucket sumber juga menggunakan setelan yang diberlakukan pemilik bucket, atau hapus semua ACL hibah objek ke akun dan grup lain AWS .
Untuk menyalin objek
Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/
-
Di panel navigasi kiri, pilih Bucket, lalu pilih tab Bucket tujuan umum. Navigasikan ke bucket atau folder Amazon S3 yang berisi objek yang ingin Anda salin.
-
Centang kotak di sebelah kiri nama objek yang ingin Anda salin.
-
Pada menu Tindakan, pilih Salin dari daftar opsi yang muncul.
-
Pilih jenis tujuan dan akun tujuan. Untuk menentukan jalur tujuan, pilih Jelajahi S3, navigasi ke tujuan, dan pilih kotak centang di sebelah kiri tujuan. Pilih Pilih tujuan di sudut kanan bawah.
Atau, masukkan jalur tujuan.
-
Jika Anda tidak mengaktifkan versi bucket, Anda akan melihat peringatan yang merekomendasikan Anda mengaktifkan Bucket Versioning untuk membantu melindungi dari penimpaan atau penghapusan objek secara tidak sengaja. Jika Anda ingin menyimpan semua versi objek dalam bucket ini, pilih Aktifkan Penentuan Versi Bucket. Anda juga dapat melihat enkripsi default dan properti Kunci Objek S3 di Detail tujuan.
-
Di bawah Pengaturan salinan tambahan, pilih apakah Anda ingin Menyalin setelan sumber, Jangan tentukan pengaturan, atau Tentukan pengaturan. Pengaturan sumber salin adalah opsi default. Jika Anda hanya ingin menyalin objek tanpa atribut pengaturan sumber, pilih Jangan tentukan pengaturan. Pilih Tentukan pengaturan untuk menentukan pengaturan untuk kelas penyimpanan, tag objekACLs, metadata, enkripsi sisi server, dan checksum tambahan.
-
Pilih Salin di sudut kanan bawah. Amazon S3 menyalin objek Anda ke tujuan.
Contoh di bagian ini memperlihatkan cara untuk menyalin objek hingga 5 GB dalam satu operasi. Untuk menyalin objek yang lebih besar dari 5 GB, Anda harus menggunakan unggahan multibagian. Untuk informasi selengkapnya, lihat Menyalin objek menggunakan unggahan multibagian.
Contoh ini menjelaskan cara menyalin objek dengan menggunakan Amazon S3 RESTAPI. Untuk informasi lebih lanjut tentang RESTAPI, lihat CopyObject.
Contoh ini menyalin objek flotsam
dari bucket
ke objek amzn-s3-demo-bucket1
jetsam
dari bucket
, dengan mempertahankan metadatanya.amzn-s3-demo-bucket2
PUT /jetsam HTTP/1.1 Host:
amzn-s3-demo-bucket2
.s3.amazonaws.com x-amz-copy-source: /amzn-s3-demo-bucket1
/flotsam Authorization: AWS AKIAIOSFODNN7EXAMPLE:ENoSbxYByFA0UGLZUqJN5EUnLDg= Date: Wed, 20 Feb 2008 22:12:21 +0000
Tanda tangannya dihasilkan dari informasi berikut.
PUT\r\n \r\n \r\n Wed, 20 Feb 2008 22:12:21 +0000\r\n x-amz-copy-source:/
amzn-s3-demo-bucket1
/flotsam\r\n /amzn-s3-demo-bucket2
/jetsam
Amazon S3 mengembalikan respons berikut yang menentukan ETag objek dan kapan terakhir diubah.
HTTP/1.1 200 OK x-amz-id-2: Vyaxt7qEbzv34BnSu5hctyyNSlHTYZFMWK4FtzO+iX8JQNyaLdTshL0KxatbaOZt x-amz-request-id: 6B13C3C5B34AF333 Date: Wed, 20 Feb 2008 22:13:01 +0000 Content-Type: application/xml Transfer-Encoding: chunked Connection: close Server: AmazonS3 <?xml version="1.0" encoding="UTF-8"?> <CopyObjectResult> <LastModified>2008-02-20T22:13:01</LastModified> <ETag>"7e9c608af58950deeb370c98608ed097"</ETag> </CopyObjectResult>
Anda juga dapat menggunakan AWS Command Line Interface (AWS CLI) untuk menyalin objek S3. Untuk informasi selengkapnya, silakan lihat copy-object
Untuk informasi tentang AWS CLI, lihat Apa itu AWS Command Line Interface? dalam AWS Command Line Interface User Guide.
Untuk memindahkan objek
Untuk memindahkan objek, gunakan metode berikut.
catatan
-
Anda dapat memindahkan objek jika objek Anda kurang dari 5 GB. Jika objek Anda lebih besar dari 5 GB, Anda harus menggunakan AWS CLIatau AWS SDKsuntuk memindahkan objek.
-
Untuk daftar izin tambahan yang diperlukan untuk memindahkan objek, lihatIzin yang diperlukan untuk operasi Amazon API S3. Misalnya kebijakan yang memberikan izin ini, lihatContoh kebijakan berbasis identitas untuk Amazon S3.
-
Objek yang dienkripsi dengan kunci enkripsi yang disediakan pelanggan (SSE-C) tidak dapat dipindahkan dengan menggunakan konsol Amazon S3. Untuk memindahkan objek yang dienkripsi dengan SSE -C, gunakan, AWS CLI AWS SDKs, atau Amazon S3. REST API
-
Saat memindahkan folder, tunggu operasi Pindahkan selesai sebelum membuat perubahan tambahan di folder.
-
Anda tidak dapat menggunakan alias titik akses S3 sebagai sumber atau tujuan untuk operasi Pindahkan di konsol Amazon S3.
Untuk memindahkan objek
-
Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/
-
Di panel navigasi, pilih Bucket, lalu pilih tab Bucket tujuan umum. Navigasikan ke bucket atau folder Amazon S3 yang berisi objek yang ingin Anda pindahkan.
-
Pilih kotak centang untuk objek yang ingin Anda pindahkan.
-
Pada menu Tindakan, pilih Pindahkan.
-
Untuk menentukan jalur tujuan, pilih Browse S3, navigasikan ke tujuan, dan pilih kotak centang tujuan. Pilih Pilih tujuan.
Atau, masukkan jalur tujuan.
-
Jika Anda tidak mengaktifkan versi bucket, Anda akan melihat peringatan yang merekomendasikan Anda mengaktifkan Bucket Versioning untuk membantu melindungi dari penimpaan atau penghapusan objek secara tidak sengaja. Jika Anda ingin menyimpan semua versi objek dalam bucket ini, pilih Aktifkan Penentuan Versi Bucket. Anda juga dapat melihat enkripsi default dan properti Object Lock di Detail tujuan.
-
Di bawah Pengaturan salinan tambahan, pilih apakah Anda ingin Menyalin setelan sumber, Jangan tentukan pengaturan, atau Tentukan pengaturan. Pengaturan sumber salin adalah opsi default. Jika Anda hanya ingin menyalin objek tanpa atribut pengaturan sumber, pilih Jangan tentukan pengaturan. Pilih Tentukan pengaturan untuk menentukan pengaturan untuk kelas penyimpanan, tag objekACLs, metadata, enkripsi sisi server, dan checksum tambahan.
-
Pilih Pindahkan di sudut kanan bawah. Amazon S3 memindahkan objek Anda ke tujuan.
Anda juga dapat menggunakan AWS Command Line Interface (AWS CLI) untuk memindahkan objek S3. Untuk informasi selengkapnya, silakan lihat mv
Untuk informasi tentang AWS CLI, lihat Apa itu AWS Command Line Interface? dalam AWS Command Line Interface User Guide.
Untuk mengganti nama objek
Untuk mengganti nama objek, gunakan prosedur berikut.
catatan
-
Anda dapat mengganti nama objek jika objek Anda kurang dari 5 GB. Untuk mengganti nama objek yang lebih besar dari 5 GB, Anda harus menggunakan AWS CLIatau AWS SDKsuntuk menyalin objek Anda dengan nama baru dan kemudian menghapus objek asli.
-
Untuk daftar izin tambahan yang diperlukan untuk menyalin objek, lihatIzin yang diperlukan untuk operasi Amazon API S3. Misalnya kebijakan yang memberikan izin ini, lihatContoh kebijakan berbasis identitas untuk Amazon S3.
-
Mengganti nama objek membuat salinan objek dengan tanggal modifikasi terakhir baru, dan kemudian menambahkan penanda hapus ke objek asli.
-
Pengaturan bucket untuk enkripsi default diterapkan secara otomatis ke objek tertentu yang tidak dienkripsi.
-
Anda tidak dapat menggunakan konsol Amazon S3 untuk mengganti nama objek dengan kunci enkripsi yang disediakan pelanggan (-C). SSE Untuk mengganti nama objek yang dienkripsi dengan SSE -C, gunakan, AWS CLI AWS SDKs, atau Amazon S3 REST API untuk menyalin objek tersebut dengan nama baru.
-
Jika bucket ini menggunakan setelan yang diberlakukan pemilik bucket untuk Kepemilikan Objek S3, daftar kontrol akses objek (ACLs) tidak akan disalin.
Untuk mengganti nama objek
Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/
-
Di panel navigasi, pilih Bucket, lalu pilih tab Bucket tujuan umum. Arahkan ke bucket Amazon S3 atau folder yang berisi objek yang ingin Anda ganti namanya.
-
Pilih kotak centang untuk objek yang ingin Anda ganti namanya.
-
Pada menu Tindakan, pilih Ganti nama objek.
-
Di kotak Nama objek baru, masukkan nama baru untuk objek tersebut.
-
Di bawah Pengaturan salinan tambahan, pilih apakah Anda ingin Menyalin setelan sumber, Jangan tentukan pengaturan, atau Tentukan pengaturan. Pengaturan sumber salin adalah opsi default. Jika Anda hanya ingin menyalin objek tanpa atribut pengaturan sumber, pilih Jangan tentukan pengaturan. Pilih Tentukan pengaturan untuk menentukan pengaturan untuk kelas penyimpanan, tag objekACLs, metadata, enkripsi sisi server, dan checksum tambahan.
-
Pilih Simpan perubahan. Amazon S3 mengganti nama objek Anda.