建立 S3 批次操作任務

使用下列命令來建立 AWS Identity and Access Management (IAM) 角色，然後建立 IAM 政策來指派相關許可。下列角色和政策會授予 Amazon S3 許可來新增物件標籤，您在後續步驟中建立任務時將會需要這些標籤。

1. 使用下列範例命令建立 IAM 角色，以供批次操作使用。若要使用此範例命令，請將 S3BatchJobRole 取代為您要為角色指定的名稱。

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

   記錄角色的 Amazon Resource Name (ARN)。建立任務時，您需要 ARN。

2. 使用下列範例命令建立具有必要許可的 IAM 政策，並將其連接至您在上一個步驟中建立的 IAM 角色。如需有關必要許可的詳細資訊，請參閱 授予批次操作的許可。

   注意

   對目錄儲存貯體執行動作的 Batch Operations 任務須具備特定許可。如需詳細資訊，請參閱適用於 AWS Identity and Access Management S3 Express One Zone 的 (IAM)。

   若要使用此範例命令，請取代 user input placeholders，如下所示：

   • S3BatchJobRole 以 IAM 角色的名稱取代 。確定此名稱與您之前使用的名稱相符。

   • PutObjectTaggingBatchJobPolicy 將 取代為您要提供 IAM 政策的名稱。

   • 將 amzn-s3-demo-destination-bucket 取代為包含您要套用標籤之物件的儲存貯體名稱。

   • Replace (取代) amzn-s3-demo-manifest-bucket 包含資訊清單的儲存貯體名稱。

   • Replace (取代) amzn-s3-demo-completion-report-bucket 包含您要交付完成報告之儲存貯體的名稱。

   aws iam put-role-policy \
     --role-name S3BatchJobRole \
     --policy-name PutObjectTaggingBatchJobPolicy \
     --policy-document '{
     "Version":"2012-10-17",
     "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/*"
         ]
       }
     ]
   }'

使用下列範例命令來建立 S3PutObjectTagging 任務。

manifest.csv 檔案提供儲存貯體和物件金鑰值的清單。該任務會將指定的標籤套用至清單檔案中識別的物件。ETag 是manifest.csv物件的 ETag，您可以從 Amazon S3 主控台取得。此請求會指定 no-confirmation-required 參數，因此您不需使用 update-job-status 命令進行確認就可以執行任務。如需詳細資訊，請參閱 create-job 在 AWS CLI 命令參考 中。

若要使用此範例命令，請以您自己的資訊取代 user input placeholders。Replace (取代) IAM-role 以及您先前建立的 ARN 角色的 IAM。

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

為了回應，Amazon S3 會傳回任務 ID (例如 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c)。您將需要任務 ID 來識別、監控和修改任務。

使用以下命令建立 AWS Identity and Access Management (IAM) 角色，然後建立 IAM 政策以指派許可。下列角色和政策會授予 Amazon S3 許可來刪除物件標籤，您在後續步驟中建立任務時將會需要這些標籤。

1. 使用下列範例命令建立 IAM 角色，以供批次操作使用。若要使用此範例命令，請將 S3BatchJobRole 取代為您要為角色指定的名稱。

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

   記錄角色的 Amazon Resource Name (ARN)。建立任務時，您將需要 ARN。

2. 使用下列範例命令建立具有必要許可的 IAM 政策，並將其連接至您在上一個步驟中建立的 IAM 角色。如需有關必要許可的詳細資訊，請參閱 授予批次操作的許可。

   注意

   對目錄儲存貯體執行動作的 Batch Operations 任務須具備特定許可。如需詳細資訊，請參閱適用於 AWS Identity and Access Management S3 Express One Zone 的 (IAM)。

   若要使用此範例命令，請取代 user input placeholders，如下所示：

   • S3BatchJobRole 以 IAM 角色的名稱取代 。確定此名稱與您之前使用的名稱相符。

   • DeleteObjectTaggingBatchJobPolicy 將 取代為您要提供 IAM 政策的名稱。

   • 將 amzn-s3-demo-destination-bucket 取代為包含您要套用標籤之物件的儲存貯體名稱。

   • 將 amzn-s3-demo-manifest-bucket 取代為要在其中儲存清單檔案的儲存貯體名稱。

   • 將 amzn-s3-demo-completion-report-bucket 取代為要接收完成報告的儲存貯體名稱。

   aws iam put-role-policy \
     --role-name S3BatchJobRole \
     --policy-name DeleteObjectTaggingBatchJobPolicy \
     --policy-document '{
     "Version":"2012-10-17",
     "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/*"
         ]
       }
     ]
   }'

使用下列範例命令來建立 S3DeleteObjectTagging 任務。

在此範例中，--report 區段中的值會指定將產生之任務報告的儲存貯體、字首、格式和範圍。此 --manifest-generator 區段會指定包含任務將對其執行動作之物件的來源儲存貯體的相關資訊、將為任務產生的清單檔案輸出清單的相關資訊，以及用來縮小要納入清單檔案中之物件範圍的篩選條件，包括建立日期、名稱限制、大小和儲存類別。命令也會指定任務的優先順序、IAM 角色和 AWS 區域。

如需詳細資訊，請參閱 create-job 在 AWS CLI 命令參考 中。

若要使用此範例命令，請以您自己的資訊取代 user input placeholders。Replace (取代) IAM-role 以及您先前建立的 ARN 角色的 IAM。

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

為了回應，Amazon S3 會傳回任務 ID (例如 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c)。您將需要此任務 ID 來識別、監控或修改任務。