Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Membuat pekerjaan Operasi Batch S3 Dengan Operasi Batch Amazon S3, Anda dapat melakukan operasi batch berskala besar pada daftar objek Amazon S3 tertentu. Bagian ini menjelaskan informasi yang Anda perlukan untuk membuat pekerjaan Operasi Batch S3 dan hasil permintaan `CreateJob`. Ini juga menyediakan instruksi untuk membuat pekerjaan Operasi Batch dengan menggunakan konsol Amazon S3, AWS Command Line Interface (AWS CLI), dan. AWS SDK untuk Java Saat membuat pekerjaan Operasi Batch S3, Anda dapat meminta laporan penyelesaian untuk semua tugas atau hanya tugas yang gagal. Selama setidaknya ada satu tugas yang berhasil diinvokasi, Operasi Batch S3 akan menghasilkan laporan untuk pekerjaan yang telah selesai, gagal, atau dibatalkan. Untuk informasi selengkapnya, lihat [Contoh: Laporan penyelesaian Operasi Batch S3](batch-ops-examples-reports.md). Video berikut menunjukkan demonstrasi singkat tentang cara membuat pekerjaan Operasi Batch dengan menggunakan konsol Amazon S3. [![AWS Videos](http://img.youtube.com/vi/https://www.youtube.com/embed/qpwHUrwAiUI//0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/qpwHUrwAiUI/) **Topics** + [Elemen permintaan pekerjaan Operasi Batch](#batch-ops-create-job-request-elements) + [Menentukan manifes](#specify-batchjob-manifest) + [Menghasilkan daftar objek secara otomatis dan menyimpannya sebagai file manifes](#automatically-generate-manifest-file) + [Membuat file manifes](#create-manifest-file) + [Menggunakan manifes yang ada](#specify-existing-manifest-file) + [Membuat tugas](#to-create-batch-ops-job) + [Respons pekerjaan](#batch-ops-create-job-response-elements) ## Elemen permintaan pekerjaan Operasi Batch Untuk membuat pekerjaan Operasi Batch S3, Anda harus memberikan informasi berikut: **Operasi** Tentukan operasi yang akan dijalankan Operasi Batch S3 terhadap objek dalam manifes. Setiap jenis operasi menerima parameter khusus untuk operasi tersebut. Dengan Operasi Batch, Anda dapat melakukan operasi secara massal, dengan hasil yang sama seperti jika Anda melakukan operasi itu one-by-one pada setiap objek. **Manifes** *Manifes* adalah daftar objek Amazon S3 yang berisi kunci objek yang Anda inginkan untuk ditindaklanjuti Amazon S3. Anda dapat menggunakan metode berikut untuk menentukan manifes yang akan digunakan dalam pekerjaan Operasi Batch: + Operasi Batch Langsung untuk menghasilkan daftar objek berdasarkan metadata yang Anda tentukan. Anda dapat menyimpan daftar ini sebagai file manifes dan menggunakannya saat Anda membuat pekerjaan Anda. Opsi ini tersedia untuk semua jenis pekerjaan yang Anda buat dengan menggunakan konsol Amazon S3, API REST Amazon S3 AWS CLI AWS SDKs, atau Amazon S3. + Hasilkan daftar objek secara otomatis berdasarkan konfigurasi replikasi yang ada. Anda dapat menyimpan daftar ini sebagai file manifes dan menggunakannya lagi untuk pekerjaan masa depan. + Buat file manifes baru secara manual. + Gunakan manifes yang ada. + Terlepas dari bagaimana Anda menentukan objek yang akan dikerjakan, manifes itu sendiri harus disimpan dalam ember tujuan umum. Operasi Batch tidak dapat mengimpor manifes yang ada dari, atau menyimpan daftar objek yang dihasilkan sebagai manifes ke bucket direktori. Objek yang dijelaskan dalam manifes tetap dapat disimpan dalam direktori bucket. Untuk informasi selengkapnya, lihat [Bucket direktori](https://docs.aws.amazon.com//AmazonS3/latest/userguide/directory-buckets-overview.html). + Jika objek dalam manifes Anda berada dalam bucket berversi, menentukan versi IDs untuk objek akan mengarahkan Operasi Batch untuk melakukan operasi pada versi tertentu. Jika tidak IDs ada versi yang ditentukan, Operasi Batch melakukan operasi pada versi terbaru objek. Jika manifes menyertakan bidang ID versi, Anda harus memberikan ID versi untuk semua objek dalam manifes. Untuk informasi selengkapnya, lihat [Menentukan manifes](#specify-batchjob-manifest). **Prioritas** Gunakan prioritas pekerjaan untuk menunjukkan prioritas relatif dari pekerjaan ini jika dibandingkan tugas lain yang berjalan di akun Anda. Angka yang lebih tinggi menunjukkan prioritas yang lebih tinggi. Prioritas pekerjaan hanya memiliki makna relatif terhadap prioritas yang ditetapkan untuk pekerjaan lain di akun dan Wilayah yang sama. Anda bisa memilih sistem penomoran yang sesuai. Misalnya, Anda mungkin ingin menetapkan semua pekerjaan **Restore** (`RestoreObject`) prioritas 1, semua pekerjaan **Copy** (`CopyObject`) prioritas 2, dan semua pekerjaan **Replace access control lists (ACLs`PutObjectAcl`)** () prioritas 3. Operasi Batch S3 memprioritaskan pekerjaan sesuai dengan urutan prioritas, tetapi tidak menjamin urutan prioritas secara teratur. Oleh karena itu, jangan gunakan prioritas pekerjaan untuk memastikan bahwa satu pekerjaan dimulai atau selesai sebelum pekerjaan lainnya. Jika Anda harus memastikan urutan secara teratur, tunggu hingga satu pekerjaan selesai sebelum memulai pekerjaan berikutnya. **RoleArn** Tentukan peran AWS Identity and Access Management (IAM) untuk menjalankan pekerjaan. Peran IAM yang Anda gunakan harus memiliki izin yang cukup untuk melakukan operasi yang ditentukan dalam pekerjaan. Misalnya, untuk menjalankan pekerjaan `CopyObject`, peran IAM harus memiliki izin `s3:GetObject` untuk bucket sumber dan izin `s3:PutObject` untuk bucket tujuan. Peran ini juga memerlukan izin untuk membaca manifes dan menulis laporan penyelesaian. Peran IAM dapat menjadi peran yang ada. Atau, jika Anda menggunakan konsol Amazon S3 untuk membuat pekerjaan, itu bisa menjadi peran IAM yang dibuat Amazon S3 secara otomatis untuk Anda. Untuk informasi selengkapnya, lihat [Memberikan izin untuk Batch Operations](batch-ops-iam-role-policies.md). Untuk informasi selengkapnya tentang peran IAM, lihat [Peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) dalam *Panduan Pengguna IAM*. Untuk informasi selengkapnya tentang izin Amazon S3, lihat [Tindakan kebijakan untuk Amazon S3](security_iam_service-with-iam.md#security_iam_service-with-iam-id-based-policies-actions). Pekerjaan Operasi Batch yang menjalankan tindakan pada bucket direktori memerlukan izin tertentu. Untuk informasi selengkapnya, lihat [AWS Identity and Access Management (IAM) untuk S3 Express One Zone](https://docs.aws.amazon.com//AmazonS3/latest/userguide/s3-express-security-iam.html). **Laporan** Tentukan apakah Anda ingin Operasi Batch S3 membuat laporan penyelesaian. Jika Anda meminta laporan penyelesaian, Anda juga harus memberikan parameter untuk laporan dalam elemen ini. Informasi berikut diperlukan: + Bucket tempat Anda ingin menyimpan laporan **catatan** Laporan harus disimpan dalam bucket yang bersifat umum. Operasi Batch tidak dapat menyimpan laporan ke bucket direktori. Untuk informasi selengkapnya, lihat [Bucket direktori](https://docs.aws.amazon.com//AmazonS3/latest/userguide/directory-buckets-overview.html). + Format laporan + Anda ingin laporan menyertakan detail semua tugas atau hanya tugas yang gagal + String prefiks opsional Jika `CreateJob.Report.ExpectedBucketOwner` bidang disediakan, diperlukan bahwa pemilik bucket laporan penyelesaian cocok. Jika tidak cocok, maka pekerjaan itu gagal. Laporan penyelesaian selalu dienkripsi dengan enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3). **Tanda (opsional)** Anda dapat melabeli dan mengontrol akses ke pekerjaan Operasi Batch S3 Anda dengan menambahkan *tag*. Anda dapat menggunakan tanda untuk mengidentifikasi pihak yang bertanggung jawab atas pekerjaan Operasi Batch, atau untuk mengontrol cara pengguna berinteraksi dengan pekerjaan Operasi Batch. Adanya tanda pekerjaan dapat memberikan atau membatasi kemampuan pengguna untuk membatalkan pekerjaan, mengaktifkan pekerjaan dalam status konfirmasi, atau mengubah tingkat prioritas pekerjaan. Misalnya, Anda dapat memberikan izin pengguna untuk menginvokasi operasi `CreateJob`, asalkan pekerjaan tersebut dibuat dengan tanda `"Department=Finance"`. Anda dapat membuat pekerjaan dengan tanda yang tersemat, dan dapat menambahkan tanda ke pekerjaan setelah Anda selesai membuatnya. Untuk informasi selengkapnya, lihat [Mengontrol akses dan melabeli pekerjaan menggunakan tanda](batch-ops-job-tags.md). **Deskripsi (opsional)** Untuk melacak dan memantau pekerjaan, Anda juga dapat memberikan deskripsi hingga 256 karakter. Amazon S3 akan menyertakan deskripsi ini setiap memberikan informasi tentang pekerjaan atau menampilkan detail pekerjaan pada konsol Amazon S3. Kemudian, Anda dapat dengan mudah mengurutkan dan memfilter pekerjaan sesuai dengan deskripsi yang Anda tetapkan. Deskripsi tidak harus unik, sehingga Anda dapat menggunakan deskripsi sebagai kategori (misalnya, "Pekerjaan Menyalin Log Mingguan") untuk memudahkan Anda melacak kelompok pekerjaan yang serupa. ## Menentukan manifes *Manifes* adalah daftar objek Amazon S3 yang berisi kunci objek yang Anda inginkan untuk ditindaklanjuti Amazon S3. Anda dapat menggunakan metode berikut untuk menentukan manifes yang akan digunakan dalam pekerjaan Operasi Batch: + Operasi Batch Langsung untuk menghasilkan daftar objek berdasarkan metadata yang Anda tentukan. Anda dapat menyimpan daftar ini sebagai manifes dan menggunakannya saat Anda membuat pekerjaan Anda. Opsi ini tersedia untuk semua jenis pekerjaan yang Anda buat dengan menggunakan konsol Amazon S3, API REST Amazon S3 AWS CLI AWS SDKs, atau Amazon S3. + Hasilkan daftar objek secara otomatis berdasarkan konfigurasi replikasi yang ada. Anda dapat menyimpan daftar ini sebagai manifes dan menggunakannya lagi untuk pekerjaan masa depan. + Buat file manifes baru secara manual. + Gunakan manifes yang ada. **catatan** Operasi Batch Amazon S3 tidak mendukung pembuatan daftar objek lintas wilayah. Terlepas dari bagaimana Anda menentukan objek yang akan dikerjakan, manifes itu sendiri harus disimpan dalam ember tujuan umum. Operasi Batch tidak dapat mengimpor manifes yang ada dari, atau menyimpan daftar objek yang dihasilkan sebagai manifes ke bucket direktori. Objek yang dijelaskan dalam manifes tetap dapat disimpan dalam direktori bucket. Untuk informasi selengkapnya, lihat [Bucket direktori](https://docs.aws.amazon.com//AmazonS3/latest/userguide/directory-buckets-overview.html). ## Menghasilkan daftar objek secara otomatis dan menyimpannya sebagai file manifes Anda dapat mengarahkan Amazon S3 untuk membuat daftar objek secara otomatis berdasarkan metadata yang Anda tentukan. Anda dapat menyimpan daftar ini sebagai manifes dan menggunakannya saat Anda membuat pekerjaan Anda. Opsi ini tersedia untuk semua jenis pekerjaan yang Anda buat dengan menggunakan konsol Amazon S3, API REST Amazon S3 AWS CLI AWS SDKs, atau Amazon S3. Untuk membuat daftar objek secara otomatis dan menyimpannya sebagai file manifes, Anda menentukan elemen berikut sebagai bagian dari permintaan pembuatan pekerjaan Anda: + Informasi tentang bucket yang berisi objek sumber Anda, termasuk pemilik bucket dan Amazon Resource Name (ARN). + Informasi tentang keluaran manifes, termasuk flag untuk membuat file manifes, pemilik bucket keluaran, ARN, awalan, format file, dan jenis enkripsi. + Kriteria opsional untuk memfilter objek berdasarkan tanggal pembuatannya, nama kunci, ukuran, jenis enkripsi, kunci KMS ARN, Kunci Bucket dan kelas penyimpanan, Dalam kasus pekerjaan replikasi, Anda juga dapat menggunakan tag untuk memfilter objek. ### Kriteria filter objek Untuk memfilter daftar objek yang akan dimasukkan dalam daftar objek yang dihasilkan secara otomatis, Anda dapat menentukan kriteria berikut. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_JobManifestGeneratorFilter.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_JobManifestGeneratorFilter.html) di *Referensi API Amazon S3*. **CreatedAfter** Jika tersedia, manifes yang dibuat hanya akan mencakup objek bucket sumber yang dibuat setelah waktu ini. **CreatedBefore** Jika tersedia, manifes yang dibuat hanya akan mencakup objek bucket sumber yang dibuat sebelum waktu ini. **EligibleForReplication** Jika tersedia, manifes yang dibuat akan mencakup objek hanya jika objek tersebut memenuhi syarat untuk direplikasi sesuai dengan konfigurasi replikasi pada bucket sumber. **KeyNameConstraint** Jika disediakan, manifes yang dihasilkan hanya mencakup objek bucket sumber yang kunci objeknya cocok dengan batasan string yang ditentukan untuk **MatchAnySubstring**,, **MatchAnyPrefix**dan. **MatchAnySuffix** **MatchAnySubstring**— Jika disediakan, manifes yang dihasilkan mencakup objek jika string yang ditentukan muncul di mana saja dalam string kunci objek. **MatchAnyPrefix**— Jika disediakan, manifes yang dihasilkan mencakup objek jika string yang ditentukan muncul di awal string kunci objek. **MatchAnySuffix**— Jika disediakan, manifes yang dihasilkan mencakup objek jika string yang ditentukan muncul di akhir string kunci objek. **MatchAnyObjectEncryption** Jika disediakan, daftar objek yang dihasilkan yang disimpan sebagai file manifes hanya menyertakan objek bucket sumber dengan tipe enkripsi sisi server yang ditunjukkan (SSE-S3, SSE-KMS, DSSE-KMS, SSE-C, atau NOT-SSE). Jika Anda memilih SSE-KMS atau DSSE-KMS, Anda dapat secara opsional memfilter hasil Anda lebih lanjut dengan menentukan ARN kunci KMS tertentu. Jika memilih SSE-KMS, Anda juga dapat memfilter hasil lebih lanjut berdasarkan status yang diaktifkan Kunci Bucket. Untuk meningkatkan kinerja pembuatan manifes saat menggunakan `KmsKeyArn` filter, gunakan filter dengan filter metadata objek lain, seperti, `MatchAnyPrefix``CreatedAfter`, atau. `MatchAnyStorageClass` **MatchAnyStorageClass** Jika tersedia, manifes yang dibuat hanya akan mencakup objek bucket sumber yang disimpan dengan kelas penyimpanan yang ditentukan. **ObjectReplicationStatuses** Jika tersedia, manifes yang dibuat hanya akan mencakup objek bucket sumber yang memiliki salah satu status replikasi yang ditentukan. **ObjectSizeGreaterThanBytes** Jika tersedia, manifes yang dibuat hanya akan mencakup objek bucket sumber yang ukuran filenya lebih besar dari jumlah byte yang ditentukan. **ObjectSizeLessThanBytes** Jika tersedia, manifes yang dibuat hanya akan mencakup objek bucket sumber yang ukuran filenya kurang dari jumlah byte yang ditentukan. **catatan** Anda tidak dapat mengkloning sebagian besar pekerjaan yang secara otomatis menghasilkan daftar objek yang disimpan sebagai manifes. Pekerjaan replikasi batch dapat dikloning, kecuali ketika pekerjaan tersebut menggunakan kriteria filter manifes `KeyNameConstraint`, `MatchAnyStorageClass`, `ObjectSizeGreaterThanBytes`, atau `ObjectSizeLessThanBytes`. Sintaks untuk menentukan kriteria manifes bervariasi tergantung pada metode yang Anda gunakan untuk membuat pekerjaan. Sebagai contoh, lihat [Membuat tugas](#to-create-batch-ops-job). ## Membuat file manifes Untuk membuat file manifes secara manual, Anda menentukan kunci objek manifes, ETag (tag entitas), dan ID versi opsional dalam daftar berformat CSV. Isi manifes harus dienkode URL. Secara default, Amazon S3 secara otomatis menggunakan enkripsi di sisi server dengan kunci terkelola Amazon S3 (SSE-S3) untuk mengenkripsi manifes yang diunggah ke bucket Amazon S3. Manifes yang menggunakan enkripsi di sisi server dengan kunci yang disediakan pelanggan (SSE-C) tidak didukung. Manifes yang menggunakan enkripsi sisi server dengan kunci AWS Key Management Service (AWS KMS) (SSE-KMS) hanya didukung saat Anda menggunakan laporan inventaris berformat CSV. Menggunakan manifes yang dibuat secara manual dengan AWS KMS tidak didukung. Manifes Anda harus berisi nama bucket, kunci objek, dan secara opsional, versi objek untuk setiap objek. Bidang lain dalam manifes tidak digunakan oleh Operasi Batch S3. **catatan** Jika objek dalam manifes Anda berada dalam bucket berversi, menentukan versi IDs untuk objek akan mengarahkan Operasi Batch untuk melakukan operasi pada versi tertentu. Jika tidak IDs ada versi yang ditentukan, Operasi Batch melakukan operasi pada versi terbaru objek. Jika manifes menyertakan bidang ID versi, Anda harus memberikan ID versi untuk semua objek dalam manifes. Berikut ini adalah contoh manifest dalam format CSV tanpa versi IDs. ``` amzn-s3-demo-bucket1,objectkey1 amzn-s3-demo-bucket1,objectkey2 amzn-s3-demo-bucket1,objectkey3 amzn-s3-demo-bucket1,photos/jpgs/objectkey4 amzn-s3-demo-bucket1,photos/jpgs/newjersey/objectkey5 amzn-s3-demo-bucket1,object%20key%20with%20spaces ``` Berikut ini adalah contoh manifes dalam format CSV yang menyertakan versi IDs. ``` amzn-s3-demo-bucket1,objectkey1,PZ9ibn9D5lP6p298B7S9_ceqx1n5EJ0p amzn-s3-demo-bucket1,objectkey2,YY_ouuAJByNW1LRBfFMfxMge7XQWxMBF amzn-s3-demo-bucket1,objectkey3,jbo9_jhdPEyB4RrmOxWS0kU0EoNrU_oI amzn-s3-demo-bucket1,photos/jpgs/objectkey4,6EqlikJJxLTsHsnbZbSRffn24_eh5Ny4 amzn-s3-demo-bucket1,photos/jpgs/newjersey/objectkey5,imHf3FAiRsvBW_EHB8GOu.NHunHO1gVs amzn-s3-demo-bucket1,object%20key%20with%20spaces,9HkPvDaZY5MVbMhn6TMn1YTb5ArQAo3w ``` ## Menggunakan manifes yang ada Anda dapat menentukan manifes yang ada untuk membuat pekerjaan Operasi Batch menggunakan salah satu dari dua format berikut: + **Laporan Inventaris Amazon S3**–Harus berupa laporan Inventaris Amazon S3 berformat CSV. Anda harus menentukan file `manifest.json` yang terkait dengan laporan inventaris. Untuk informasi selengkapnya tentang laporan inventaris, lihat [Membuat katalog dan menganalisis data Anda dengan S3 Inventory](storage-inventory.md). Jika laporan inventaris menyertakan versi IDs, Operasi Batch S3 beroperasi pada versi objek tertentu. **catatan** Operasi Batch S3 mendukung *laporan inventaris *CSV yang dienkripsi dengan SSE-KMS. Jika Anda mengirimkan manifes laporan inventaris yang dienkripsi dengan SSE-KMS, kebijakan IAM Anda harus menyertakan izin `"kms:Decrypt"` dan `"kms:GenerateDataKey"` untuk objek `manifest.json` serta semua file data CSV terkait. + **File CSV**–Setiap baris dalam file harus menyertakan nama bucket, kunci objek, dan secara opsional, versi objek. Kunci objek harus dienkode URL, seperti yang ditunjukkan dalam contoh berikut. Manifes harus menyertakan versi IDs untuk semua objek atau menghilangkan versi IDs untuk semua objek. Untuk informasi selengkapnya tentang format manifes CSV, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_JobManifestSpec.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_JobManifestSpec.html) di *Referensi API Amazon Simple Storage Service*. **catatan** Operasi Batch S3 tidak mendukung *file manifes* CSV yang dienkripsi dengan SSE-KMS. **penting** Saat menggunakan manifes yang dibuat secara manual dan bucket berversi, sebaiknya tentukan versi IDs untuk objek tersebut. Saat Anda membuat pekerjaan, Operasi Batch S3 mengurai seluruh manifes sebelum menjalankan pekerjaan tersebut. Namun, proses tersebut tidak mengambil "snapshot" dari status bucket. Karena manifes dapat berisi miliaran objek, pekerjaan mungkin membutuhkan waktu yang lama untuk dijalankan, sehingga dapat memengaruhi versi objek yang ditindaklanjuti oleh pekerjaan tersebut. Misalnya, Anda menimpa objek dengan versi baru saat pekerjaan berjalan dan Anda tidak menentukan ID versi untuk objek tersebut. Dalam hal ini, Amazon S3 akan melakukan operasi pada versi terbaru dari objek tersebut, bukan pada versi yang ada ketika Anda membuat pekerjaan. Satu-satunya cara untuk menghindari perilaku ini adalah dengan menentukan versi IDs untuk objek yang terdaftar dalam manifes. ## Membuat tugas Anda dapat membuat pekerjaan Operasi Batch S3 dengan menggunakan konsol Amazon S3 AWS CLI, AWS SDKs, atau Amazon S3 REST API. Untuk informasi selengkapnya tentang cara membuat permintaan pekerjaan, lihat [Elemen permintaan pekerjaan Operasi Batch](#batch-ops-create-job-request-elements). **Prasyarat** Sebelum membuat pekerjaan Operasi Batch, konfirmasikan bahwa Anda telah mengonfigurasi izin yang relevan. Untuk informasi selengkapnya, lihat [Memberikan izin untuk Batch Operations](batch-ops-iam-role-policies.md). ### Menggunakan konsol S3 **Untuk membuat pekerjaan Operasi Batch menggunakan konsol 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. Pilih **Operasi Batch** di panel navigasi kiri konsol Amazon S3. 1. Pilih **Buat tugas**. 1. Di bawah **Pilih Wilayah dan cakupan**, pilih dan lihat AWS Wilayah tempat Anda ingin membuat pekerjaan. **catatan** Untuk operasi penyalinan, Anda harus membuat pekerjaan di Wilayah yang sama dengan bucket tujuan. Untuk semua operasi lainnya, Anda harus membuat pekerjaan di Wilayah yang sama dengan objek dalam manifes. 1. Untuk **Cakupan**, tentukan daftar objek yang akan ditindaklanjuti oleh pekerjaan Operasi Batch Anda. Di bawah **Daftar objek**, Anda dapat memilih untuk membuat manifes menggunakan daftar objek, menghasilkan manifes menggunakan konfigurasi replikasi, atau menggunakan manifes yang ada. + Jika Anda memilih **Menghasilkan daftar objek**, daftar objek dibuat secara otomatis berdasarkan lokasi sumber dan metadata yang Anda tentukan. Anda dapat menyimpan daftar ini sebagai manifes dan menggunakannya lagi untuk pekerjaan masa depan. **catatan** Untuk membuat daftar objek, Anda harus memiliki `s3:PutInventoryConfiguration` izin. Ember sumber harus berupa ember tujuan umum. + Jika Anda memilih **Gunakan manifes yang ada**, Anda dapat mengimpor daftar objek dari manifes yang ada. Manifes adalah laporan Inventaris S3 atau file CV yang mencantumkan objek tertentu yang Anda inginkan untuk ditindaklanjuti oleh Operasi Batch. + Jika Anda memilih **Gunakan konfigurasi replikasi**, Anda dapat membuat daftar objek secara otomatis berdasarkan konfigurasi replikasi yang ada. Anda dapat menyimpan daftar ini sebagai manifes dan menggunakannya lagi untuk pekerjaan masa depan. Untuk contoh ini, pilih **Hasilkan daftar objek**. 1. Untuk **akun Sumber**, pilih akun yang memiliki objek sumber. 1. Di bawah **Sumber**, masukkan jalur ke sumber Anda, misalnya, `s3://`*amzn-s3-demo-bucket*. 1. Di bawah **Filter objek**, Anda dapat menggunakan filter untuk memfilter berdasarkan bagian mana pun dari kunci objek atau untuk memfilter pada akhir kunci objek. **Filter kunci Object** membantu dalam menyempurnakan daftar objek yang akan digunakan dalam manifes. Untuk **filter metadata Object**, pilih filter untuk lebih menentukan cakupan objek yang akan disertakan dalam manifes. 1. Di bawah **Pilih operasi**, pilih jenis operasi yang ingin Anda lakukan pada semua objek yang tercantum dalam manifes. Jika manifes Anda mereferensikan objek yang disimpan dalam bucket direktori, hanya gunakan salin atau panggil operasi fungsi AWS Lambda. Semua operasi lainnya tidak didukung. 1. Setelah memilih jenis operasi Anda, pilih **Berikutnya**. 1. Isi informasi untuk **Konfigurasi opsi tambahan**. Untuk **Izin**, tentukan peran AWS Identity and Access Management (IAM) yang ingin digunakan oleh pekerjaan tersebut. Ini bisa menjadi peran yang ada, atau peran yang dibuat Amazon S3 secara otomatis untuk Anda. Untuk informasi selengkapnya, lihat [Memberikan izin untuk Batch Operations](batch-ops-iam-role-policies.md). Amazon S3 dapat membuat peran untuk Anda jika Anda mengonfigurasi pekerjaan untuk menggunakan daftar objek yang dihasilkan S3 dengan filter atau daftar objek berdasarkan konfigurasi replikasi. 1. Setelah Anda selesai mengonfigurasi opsi tambahan, pilih **Berikutnya**. 1. Untuk **Peninjauan**, verifikasikan pengaturan. Jika Anda perlu membuat perubahan, pilih **Sebelumnya**. Jika tidak, Anda dapat memilih **Kirim pekerjaan**. ### Menggunakan AWS CLI Untuk membuat pekerjaan Operasi Batch Anda dengan AWS CLI, pilih salah satu contoh berikut, tergantung pada apakah Anda menentukan manifes yang ada atau membuat manifes secara otomatis. ------ #### [ Specify manifest ] Contoh berikut menunjukkan cara menggunakan AWS CLI untuk membuat `S3PutObjectTagging` pekerjaan Operasi Batch S3 yang bertindak pada objek yang terdaftar dalam file manifes yang ada. **Untuk membuat `S3PutObjectTagging` pekerjaan Operasi Batch dengan menentukan manifes** 1. Gunakan perintah berikut untuk membuat peran AWS Identity and Access Management (IAM), lalu buat kebijakan IAM untuk menetapkan izin yang relevan. Peran dan kebijakan berikut memberikan izin Amazon S3 untuk menambahkan tanda objek yang akan Anda perlukan saat membuat pekerjaan di langkah berikutnya. 1. Gunakan perintah contoh berikut untuk membuat peran IAM untuk Operasi Batch yang akan digunakan. Untuk menggunakan contoh perintah ini, ganti `S3BatchJobRole` dengan nama yang ingin Anda berikan ke peran tersebut. ``` aws iam create-role \ --role-name S3BatchJobRole \ --assume-role-policy-document '{ "Version": "2012-10-17" , "Statement":[ { "Effect":"Allow", "Principal":{ "Service":"batchoperations.s3.amazonaws.com" }, "Action":"sts:AssumeRole" } ] }' ``` Catat Amazon Resource Name (ARN) untuk peran. Anda akan membutuhkan ARN saat membuat pekerjaan. 1. Gunakan contoh berikut untuk membuat kebijakan IAM dengan izin yang diperlukan dan lampirkan ke peran IAM yang Anda buat di langkah sebelumnya. Untuk informasi selengkapnya tentang izin yang diperlukan, lihat [Memberikan izin untuk Batch Operations](batch-ops-iam-role-policies.md). **catatan** Pekerjaan Operasi Batch yang menjalankan tindakan pada bucket direktori memerlukan izin tertentu. Untuk informasi selengkapnya, lihat [AWS Identity and Access Management (IAM) untuk S3 Express One Zone](https://docs.aws.amazon.com//AmazonS3/latest/userguide/s3-express-security-iam.html). Untuk menggunakan perintah contoh ini, ganti `user input placeholders` sebagai berikut: + Ganti `S3BatchJobRole` dengan nama peran IAM Anda. Pastikan nama ini cocok dengan nama yang Anda gunakan sebelumnya. + Ganti `PutObjectTaggingBatchJobPolicy` dengan nama yang ingin Anda berikan pada kebijakan IAM. + Ganti `amzn-s3-demo-destination-bucket` dengan nama bucket yang berisi objek yang ingin Anda berikan tanda. + Ganti *`amzn-s3-demo-manifest-bucket`* dengan nama bucket yang berisi manifes. + Ganti *`amzn-s3-demo-completion-report-bucket`* dengan nama bucket tujuan pengiriman laporan penyelesaian. ``` aws iam put-role-policy \ --role-name S3BatchJobRole \ --policy-name PutObjectTaggingBatchJobPolicy \ --policy-document '{ "Version": "2012-10-17" , TCX5-2025-waiver;, "Statement":[ { "Effect":"Allow", "Action":[ "s3:PutObjectTagging", "s3:PutObjectVersionTagging" ], "Resource": "arn:aws:s3:::amzn-s3-demo-destination-bucket/*" }, { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion", "s3:GetBucketLocation" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-manifest-bucket", "arn:aws:s3:::amzn-s3-demo-manifest-bucket/*" ] }, { "Effect":"Allow", "Action":[ "s3:PutObject", "s3:GetBucketLocation" ], "Resource":[ "arn:aws:s3:::amzn-s3-demo-completion-report-bucket", "arn:aws:s3:::amzn-s3-demo-completion-report-bucket/*" ] } ] }' ``` 1. Gunakan contoh perintah berikut untuk membuat pekerjaan `S3PutObjectTagging`. File `manifest.csv` menyediakan daftar bucket dan nilai kunci objek. Pekerjaan ini menerapkan tanda yang ditentukan ke objek yang diidentifikasi dalam manifes. `ETag`Itu adalah ETag `manifest.csv` objek, yang bisa Anda dapatkan dari konsol Amazon S3. Permintaan ini menentukan parameter `no-confirmation-required`, sehingga Anda dapat menjalankan pekerjaan tanpa harus mengonfirmasinya dengan perintah `update-job-status`. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/cli/latest/reference/s3control/create-job.html](https://docs.aws.amazon.com/cli/latest/reference/s3control/create-job.html) di *AWS CLI Referensi Perintah*. Untuk menggunakan perintah contoh ini, ganti `user input placeholders` dengan informasi Anda sendiri. Ganti *`IAM-role`* dengan ARN peran IAM yang Anda buat sebelumnya. ``` aws s3control create-job \ --region us-west-2 \ --account-id acct-id \ --operation '{"S3PutObjectTagging": { "TagSet": [{"Key":"keyOne", "Value":"ValueOne"}] }}' \ --manifest '{"Spec":{"Format":"S3BatchOperations_CSV_20180820","Fields":["Bucket","Key"]},"Location":{"ObjectArn":"arn:aws:s3:::amzn-s3-demo-manifest-bucket/manifest.csv","ETag":"60e460c9d1046e73f7dde5043ac3ae85"}}' \ --report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket","Prefix":"final-reports", "Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \ --priority 42 \ --role-arn IAM-role \ --client-request-token $(uuidgen) \ --description "job description" \ --no-confirmation-required ``` Sebagai tanggapan, Amazon S3 akan mengembalikan ID pekerjaan (misalnya, `00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c`). Anda akan memerlukan ID pekerjaan untuk mengidentifikasi, memantau, dan mengubah pekerjaan. ------ #### [ Generate manifest ] Contoh berikut menunjukkan cara membuat pekerjaan `S3DeleteObjectTagging` Operasi Batch S3 yang secara otomatis membuat manifes berdasarkan kriteria filter objek Anda. Kriteria ini mencakup tanggal pembuatan, nama kunci, ukuran, kelas penyimpanan, dan tanda. **Untuk membuat `S3DeleteObjectTagging` pekerjaan Operasi Batch dengan membuat manifes** 1. Gunakan perintah berikut untuk membuat peran AWS Identity and Access Management (IAM), lalu buat kebijakan IAM untuk menetapkan izin. Peran dan kebijakan berikut memberikan izin Amazon S3 untuk menghapus tanda objek, yang akan Anda perlukan saat membuat pekerjaan di langkah berikutnya. 1. Gunakan perintah contoh berikut untuk membuat peran IAM untuk Operasi Batch yang akan digunakan. Untuk menggunakan contoh perintah ini, ganti `S3BatchJobRole` dengan nama yang ingin Anda berikan ke peran tersebut. ``` aws iam create-role \ --role-name S3BatchJobRole \ --assume-role-policy-document '{ "Version": "2012-10-17" , TCX5-2025-waiver;, "Statement":[ { "Effect":"Allow", "Principal":{ "Service":"batchoperations.s3.amazonaws.com" }, "Action":"sts:AssumeRole" } ] }' ``` Catat Amazon Resource Name (ARN) untuk peran. Anda akan membutuhkan ARN saat membuat pekerjaan. 1. Gunakan contoh berikut untuk membuat kebijakan IAM dengan izin yang diperlukan dan lampirkan ke peran IAM yang Anda buat di langkah sebelumnya. Untuk informasi selengkapnya tentang izin yang diperlukan, lihat [Memberikan izin untuk Batch Operations](batch-ops-iam-role-policies.md). **catatan** Pekerjaan Operasi Batch yang menjalankan tindakan pada bucket direktori memerlukan izin tertentu. Untuk informasi selengkapnya, lihat [AWS Identity and Access Management (IAM) untuk S3 Express One Zone](https://docs.aws.amazon.com//AmazonS3/latest/userguide/s3-express-security-iam.html). Untuk menggunakan perintah contoh ini, ganti `user input placeholders` sebagai berikut: + Ganti `S3BatchJobRole` dengan nama peran IAM Anda. Pastikan nama ini cocok dengan nama yang Anda gunakan sebelumnya. + Ganti `DeleteObjectTaggingBatchJobPolicy` dengan nama yang ingin Anda berikan pada kebijakan IAM. + Ganti `amzn-s3-demo-destination-bucket` dengan nama bucket yang berisi objek yang ingin Anda berikan tanda. + Ganti `amzn-s3-demo-manifest-bucket` dengan nama bucket tempat Anda ingin menyimpan manifes. + Ganti `amzn-s3-demo-completion-report-bucket` dengan nama bucket tujuan pengiriman laporan penyelesaian. ``` aws iam put-role-policy \ --role-name S3BatchJobRole \ --policy-name DeleteObjectTaggingBatchJobPolicy \ --policy-document '{ "Version": "2012-10-17" , TCX5-2025-waiver;, "Statement":[ { "Effect":"Allow", "Action":[ "s3:DeleteObjectTagging", "s3:DeleteObjectVersionTagging" ], "Resource": "arn:aws:s3:::amzn-s3-demo-destination-bucket/*" }, { "Effect":"Allow", "Action":[ "s3:PutInventoryConfiguration" ], "Resource": "arn:aws:s3:::amzn-s3-demo-destination-bucket" }, { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-manifest-bucket", "arn:aws:s3:::amzn-s3-demo-manifest-bucket/*" ] }, { "Effect":"Allow", "Action":[ "s3:PutObject", "s3:ListBucket" ], "Resource":[ "arn:aws:s3:::amzn-s3-demo-completion-report-bucket", "arn:aws:s3:::amzn-s3-demo-completion-report-bucket/*", "arn:aws:s3:::amzn-s3-demo-manifest-bucket/*" ] } ] }' ``` 1. Gunakan contoh berikut untuk membuat pekerjaan `S3DeleteObjectTagging`. Dalam contoh ini, nilai di bagian `--report` menentukan bucket, prefiks, format, dan cakupan laporan pekerjaan yang akan dihasilkan. Bagian `--manifest-generator` ini menentukan informasi tentang bucket sumber yang berisi objek yang akan ditindaklanjuti oleh pekerjaan, informasi tentang daftar output manifes yang akan dibuat untuk pekerjaan, dan kriteria filter untuk mempersempit cakupan objek yang akan disertakan dalam manifes berdasarkan tanggal pembuatan, batasan nama, ukuran, dan kelas penyimpanan. Perintah ini juga menentukan prioritas pekerjaan, peran IAM, dan Wilayah AWS. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/cli/latest/reference/s3control/create-job.html](https://docs.aws.amazon.com/cli/latest/reference/s3control/create-job.html) di *AWS CLI Referensi Perintah*. Untuk menggunakan perintah contoh ini, ganti `user input placeholders` dengan informasi Anda sendiri. Ganti *`IAM-role`* dengan ARN peran IAM yang Anda buat sebelumnya. ``` aws s3control create-job \ --account-id 012345678901 \ --operation '{ "S3DeleteObjectTagging": {} }' \ --report '{ "Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket", "Prefix":"reports", "Format":"Report_CSV_20180820", "Enabled":true, "ReportScope":"AllTasks" }' \ --manifest-generator '{ "S3JobManifestGenerator": { "ExpectedBucketOwner": "012345678901", "SourceBucket": "arn:aws:s3:::amzn-s3-demo-source-bucket", "EnableManifestOutput": true, "ManifestOutputLocation": { "ExpectedManifestBucketOwner": "012345678901", "Bucket": "arn:aws:s3:::amzn-s3-demo-manifest-bucket", "ManifestPrefix": "prefix", "ManifestFormat": "S3InventoryReport_CSV_20211130" }, "Filter": { "CreatedAfter": "2023-09-01", "CreatedBefore": "2023-10-01", "KeyNameConstraint": { "MatchAnyPrefix": [ "prefix" ], "MatchAnySuffix": [ "suffix" ] }, "ObjectSizeGreaterThanBytes": 100, "ObjectSizeLessThanBytes": 200, "MatchAnyStorageClass": [ "STANDARD", "STANDARD_IA" ] } } }' \ --priority 2 \ --role-arn IAM-role \ --region us-east-1 ``` Sebagai tanggapan, Amazon S3 akan mengembalikan ID pekerjaan (misalnya, `00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c`). Anda akan memerlukan ID pekerjaan ini untuk mengidentifikasi, memantau, atau mengubah pekerjaan. ------ ### Menggunakan AWS SDK untuk Java Untuk membuat pekerjaan Operasi Batch dengan AWS SDK for Java, Anda dapat memilih di antara dua pendekatan tergantung pada apakah Anda menentukan manifes yang ada atau membuat manifes secara otomatis: + *Tentukan manifes yang ada:* Buat pekerjaan Operasi Batch S3 (seperti`S3PutObjectTagging`) yang bertindak pada objek yang terdaftar dalam file manifes yang ada. Pendekatan ini mengharuskan Anda untuk memberikan lokasi manifes ETag,, dan spesifikasi format. + *Hasilkan manifes secara otomatis:* Buat pekerjaan Operasi Batch S3 (seperti`s3PutObjectCopy`) yang secara otomatis menghasilkan manifes berdasarkan kriteria filter objek, termasuk tanggal pembuatan, nama kunci, dan batasan ukuran. Kedua pendekatan menggunakan klien S3Control untuk mengonfigurasi operasi pekerjaan, spesifikasi manifes, laporan pekerjaan, peran IAM, dan parameter pekerjaan lainnya termasuk persyaratan prioritas dan konfirmasi. Untuk contoh cara membuat pekerjaan Operasi Batch S3 dengan AWS SDK for Java, [lihat Membuat pekerjaan batch untuk menyalin](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_CreateJob_section.html) objek di Referensi API *Amazon S3*. ### Penggunaan API REST Anda dapat menggunakan API REST untuk membuat pekerjaan Operasi Batch. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateJob.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateJob.html) di *Referensi API Amazon Simple Storage Service*. ## Respons pekerjaan Jika permintaan `CreateJob` berhasil, Amazon S3 akan mengembalikan ID pekerjaan. ID pekerjaan adalah pengenal unik yang dihasilkan secara otomatis oleh Amazon S3 sehingga Anda dapat mengidentifikasi pekerjaan Operasi Batch dan memantau statusnya. Saat Anda membuat pekerjaan melalui AWS CLI, AWS SDKs, atau REST API, Anda dapat mengatur Operasi Batch S3 untuk mulai memproses pekerjaan secara otomatis. Pekerjaan akan segera dijalankan setelah siap, tanpa harus menunggu pekerjaan yang lebih diprioritaskan. Saat membuat pekerjaan melalui konsol Amazon S3, Anda harus meninjau detail pekerjaan dan mengonfirmasi bahwa Anda ingin menjalankannya sebelum Operasi Batch dapat mulai memprosesnya. Jika suatu pekerjaan tetap berada dalam status ditangguhkan selama lebih dari 30 hari, pekerjaan tersebut akan gagal.