Membuat pekerjaan Operasi Batch S3

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.

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

   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.

   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/*"
         ]
       }
     ]
   }'

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. ETagItu 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 create-job 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.

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.

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

   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.

   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/*"
         ]
       }
     ]
   }'

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