Création d'une tâche d'opérations par lot S3

Utilisez les commandes suivantes pour créer un rôle AWS Identity and Access Management (IAM), puis créez une IAM politique pour attribuer les autorisations appropriées. Le rôle et la politique suivants accordent à Amazon S3 l’autorisation d’ajouter des balises d’objet, dont vous aurez besoin lors de la création de la tâche dans une étape ultérieure.

1. Utilisez l'exemple de commande suivant pour créer un IAM rôle à utiliser par Batch Operations. Pour utiliser cet exemple de commande, remplacez S3BatchJobRole par le nom que vous souhaitez donner à ce rôle.

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

   Enregistrez le nom de la ressource Amazon du rôle (ARN). Vous en aurez besoin ARN lorsque vous créerez un emploi.

2. Utilisez l'exemple de commande suivant pour créer une IAM politique avec les autorisations nécessaires et l'associer au IAM rôle que vous avez créé à l'étape précédente. Pour plus d’informations sur les autorisations nécessaires, consultez Octroi d'autorisations pour les opérations par lots.

   Note

   Les tâches d’opérations par lots qui effectuent des actions sur des compartiments de répertoires nécessitent des autorisations spécifiques. Pour plus d'informations, consultez AWS Identity and Access Management (IAM) pour S3 Express One Zone.

   Pour utiliser cet exemple de commande, remplacez les user input placeholders comme suit :

   • Remplacez S3BatchJobRole par le nom de votre IAM rôle. Assurez-vous que ce nom correspond au nom que vous avez utilisé précédemment.

   • PutObjectTaggingBatchJobPolicyRemplacez-le par le nom que vous souhaitez donner à votre IAM politique.

   • Remplacez amzn-s3-demo-destination-bucket par le nom du compartiment qui contient les objets auxquels vous souhaitez appliquer des balises.

   • Remplacez amzn-s3- demo-manifest-bucket avec le nom du bucket qui contient le manifeste.

   • Remplacez amzn-s3- demo-completion-report-bucket avec le nom du compartiment dans lequel vous souhaitez que le rapport d'achèvement soit livré.

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

Utilisez l’exemple de commande suivant pour créer une tâche S3PutObjectTagging.

Le fichier manifest.csv fournit une liste des valeurs de compartiment et de clé d'objet. Cette tâche applique les balises spécifiées aux objets identifiés dans le manifeste. ETagIl s'agit ETag de l'manifest.csvobjet, que vous pouvez obtenir depuis la console Amazon S3. Cette demande spécifie le paramètre no-confirmation-required, afin que vous puissiez exécuter la tâche sans avoir à la confirmer avec la commande update-job-status. Pour plus d’informations, consultez .create-jobdans la référence de AWS CLI commande.

Pour utiliser cet exemple de commande, remplacez user input placeholders par vos propres informations. Remplacez IAM-rôle avec ARN le IAM rôle que vous avez créé précédemment.

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

En réponse, Amazon S3 renvoie un ID de tâche (par exemple, 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c). Vous aurez besoin de l’ID de la tâche pour identifier, surveiller et modifier la tâche.

Utilisez les commandes suivantes pour créer un rôle AWS Identity and Access Management (IAM), puis créez une IAM politique pour attribuer des autorisations. Le rôle et la politique suivants accordent à Amazon S3 l’autorisation de supprimer des balises d’objet, dont vous aurez besoin lors de la création de la tâche dans une étape ultérieure.

1. Utilisez l'exemple de commande suivant pour créer un IAM rôle à utiliser par Batch Operations. Pour utiliser cet exemple de commande, remplacez S3BatchJobRole par le nom que vous souhaitez donner à ce rôle.

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

   Enregistrez le nom de la ressource Amazon du rôle (ARN). Vous en aurez besoin ARN lorsque vous créerez un emploi.

2. Utilisez l'exemple de commande suivant pour créer une IAM politique avec les autorisations nécessaires et l'associer au IAM rôle que vous avez créé à l'étape précédente. Pour plus d’informations sur les autorisations nécessaires, consultez Octroi d'autorisations pour les opérations par lots.

   Note

   Les tâches d’opérations par lots qui effectuent des actions sur des compartiments de répertoires nécessitent des autorisations spécifiques. Pour plus d'informations, consultez AWS Identity and Access Management (IAM) pour S3 Express One Zone.

   Pour utiliser cet exemple de commande, remplacez les user input placeholders comme suit :

   • Remplacez S3BatchJobRole par le nom de votre IAM rôle. Assurez-vous que ce nom correspond au nom que vous avez utilisé précédemment.

   • DeleteObjectTaggingBatchJobPolicyRemplacez-le par le nom que vous souhaitez donner à votre IAM politique.

   • Remplacez amzn-s3-demo-destination-bucket par le nom du compartiment qui contient les objets auxquels vous souhaitez appliquer des balises.

   • Remplacez amzn-s3-demo-manifest-bucket par le nom du compartiment dans lequel vous voulez enregistrer le manifeste.

   • Remplacez amzn-s3-demo-completion-report-bucket par le nom du compartiment dans lequel vous voulez livrer le rapport d’achèvement.

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

Utilisez l’exemple de commande suivant pour créer la tâche S3DeleteObjectTagging.

Dans cet exemple, les valeurs de la section --report spécifient le compartiment, le préfixe, le format et la portée du rapport de tâche qui sera généré. La section --manifest-generator fournit des informations sur le compartiment source qui contient les objets sur lesquels la tâche agira, des informations sur la liste de sortie du manifeste qui sera générée pour la tâche et les critères de filtre permettant de réduire l’étendue des objets à inclure dans le manifeste en fonction de la date de création, de contraintes de nom, de la taille et de la classe de stockage. La commande spécifie également la priorité, le rôle et IAM le rôle de la tâche Région AWS.

Pour plus d’informations, consultez .create-jobdans la référence de AWS CLI commande.

Pour utiliser cet exemple de commande, remplacez user input placeholders par vos propres informations. Remplacez IAM-rôle avec ARN le IAM rôle que vous avez créé précédemment.

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

En réponse, Amazon S3 renvoie un ID de tâche (par exemple, 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c). Vous aurez besoin de cet ID de tâche pour identifier, surveiller ou modifier la tâche.