Créer une tâche de réplication par lot pour les règles de réplication existantes

Vous pouvez configurer la réplication par lots S3 pour une configuration de réplication existante à l'aide du AWS SDKs, AWS Command Line Interface (AWS CLI), ou la console Amazon S3. Pour obtenir une présentation de la réplication par lot, consultez Réplication d'objets existants via la réplication par lot S3.

Comme condition préalable, vous devez créer un Batch Operations AWS Identity and Access Management (IAM) rôle pour accorder à Amazon S3 l'autorisation d'effectuer des actions en votre nom, voirConfiguration des IAM politiques pour la réplication par lots.

Lorsque la tâche de réplication par lot est terminée, vous recevez un rapport de fin d'opérations. Pour plus d'informations sur l'utilisation du rapport pour examiner la tâche, consultez Suivi de l'état de la tâche et des rapports de fin de tâche.

Utilisation de la console S3

1. Connectez-vous au AWS Management Console et ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/.

2. Choisissez Opérations par lot dans le panneau de navigation de la console Amazon S3.

3. Choisissez Create job (Créer une tâche).

4. Choisissez la Région dans laquelle vous souhaitez créer la tâche.

5. Sélectionnez le Manifest format (format du manifeste). Cet exemple montre comment créer un manifeste basé sur une configuration de réplication S3 existante.

   Note

   Le manifeste est la liste de tous les objets sur lesquels vous souhaitez exécuter l'action spécifiée. Pour en savoir plus sur les manifestes des opérations par lot, consultez Spécification d'un manifeste. Si vous avez préparé un manifeste, choisissez le rapport d'inventaire S3 (manifest.json) ou. CSV Si les objets de votre manifeste se trouvent dans un compartiment versionné, vous devez spécifier la version IDs des objets. Pour plus d'informations sur la création d'un manifeste, consultez Spécification d'un manifeste.

6. Pour créer un manifeste basé sur votre configuration de la réplication, choisissez Create manifest using S3 Replication configuration (Créer un manifeste à l'aide de la configuration de réplication S3). Ajoutez ensuite le compartiment source à votre configuration de la réplication.

7. (Facultatif) Vous pouvez inclure des filtres supplémentaires tels que la date de création d'objets et le statut de la réplication. Pour obtenir des exemples de filtrage par statut de réplication, consultez Spécification d'un manifeste pour une tâche de réplication par lot.

8. Pour enregistrer un manifeste, sélectionnez Save Batch Operations manifest (Enregistrer le manifeste des opérations par lot).

   1. Si vous choisissez de générer et d'enregistrer un manifeste, vous devez choisir Bucket dans ce compte ou Bucket dans un autre Compte AWS. Spécifiez le nom du compartiment dans la zone de texte.

      Note

      Le manifeste généré doit être stocké dans le même Région AWS en tant que compartiment source.

   2. Choisissez le Type de chiffrement.

9. (Facultatif) Fournissez une description.

10. Ajustez la Priority (priorité) de la tâche si nécessaire. Un nombre plus élevé est synonyme de priorité supérieure. Simple Storage Service (Amazon S3) tente d'exécuter des tâches à priorité supérieure avant les tâches à priorité inférieure. Pour plus d’informations sur la priorité des tâches, consultez Affectation d'une priorité de tâche.

11. (Facultatif) Générez un rapport de fin de tâche. Pour générer, sélectionnez Generate completion report (Générer un rapport de fin de tâche).

    Si vous choisissez de générer un rapport de fin de tâche, vous devez choisir de créer un rapport concernant Failed tasks only (uniquement les tâches ayant échoué) ou All tasks (toutes les tâches), et fournir un compartiment de destination pour le rapport.

12. Sélectionnez un IAM rôle valide.

    Note

    Pour plus d'informations sur la création d'un IAM rôle, consultezConfiguration des IAM politiques pour la réplication par lots.

13. (Facultatif) Ajoutez des identifications de tâche à la tâche de réplication par lot.

14. Choisissez Next (Suivant).

15. Vérifiez votre configuration de la tâche et sélectionnez Create job (Créer une tâche).

Utilisation de AWS CLI avec un manifeste S3

L'exemple suivant crée une tâche de réplication par lots S3 à l'aide d'un manifeste généré par S3 pour le Compte AWS 111122223333. Cet exemple va essayer de répliquer des objets existants et des objets qui n'avaient pas pu être répliqués auparavant. Pour plus d'informations sur le filtrage par statut de réplication, consultez Spécification d'un manifeste pour une tâche de réplication par lot.

aws s3control create-job --account-id 111122223333 --operation '{"S3ReplicateObject":{}}' --report '{"Bucket":"arn:aws:s3:::*** completion report bucket ****","Prefix":"batch-replication-report", "Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' --manifest-generator '{"S3JobManifestGenerator": {"ExpectedBucketOwner": "111122223333", "SourceBucket": "arn:aws:s3:::*** replication source bucket ***", "EnableManifestOutput": false, "Filter": {"EligibleForReplication": true, "ObjectReplicationStatuses": ["NONE","FAILED"]}}}' --priority 1 --role-arn arn:aws:iam::111122223333:role/batch-Replication-IAM-policy --no-confirmation-required --region source-bucket-region

Note

La tâche doit être initiée à partir du même Région AWS compartiment source de réplication. Le IAM rôle role/batch-Replication-IAM-policy a déjà été créé. Consultez Configuration des IAM politiques pour la réplication par lots.

Une fois que vous avez lancé avec succès une tâche de réplication par lot, vous recevez l'ID de la tâche en tant que réponse. Vous pouvez surveiller cette tâche à l'aide de la commande suivante.

aws s3control describe-job --account-id 111122223333 --job-id job-id --region source-bucket-region

Utilisation de AWS CLI avec un manifeste fourni par l'utilisateur

L'exemple suivant crée une tâche de réplication par lots S3 à l'aide d'un manifeste défini par l'utilisateur pour Compte AWS 111122223333. Si les objets de votre manifeste se trouvent dans un compartiment versionné, vous devez spécifier la version IDs des objets. Seul l'objet dont l'ID de version est spécifié dans l'attaque de l'homme du milieu (HDM) sera répliqué. Pour plus d'informations sur la création d'un manifeste, consultez Spécification d'un manifeste.

aws s3control create-job --account-id 111122223333 --operation '{"S3ReplicateObject":{}}' --report '{"Bucket":"arn:aws:s3:::*** completion report bucket ****","Prefix":"batch-replication-report", "Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' --manifest '{"Spec":{"Format":"S3BatchOperations_CSV_20180820","Fields":["Bucket","Key","VersionId"]},"Location":{"ObjectArn":"arn:aws:s3:::*** completion report bucket ****/manifest.csv","ETag":"Manifest Etag"}}' --priority 1 --role-arn arn:aws:iam::111122223333:role/batch-Replication-IAM-policy --no-confirmation-required --region source-bucket-region

Note

La tâche doit être initiée à partir du même Région AWS compartiment source de réplication. Le IAM rôle role/batch-Replication-IAM-policy a déjà été créé. Consultez Configuration des IAM politiques pour la réplication par lots.

Une fois que vous avez lancé avec succès une tâche de réplication par lot, vous recevez l'ID de la tâche en tant que réponse. Vous pouvez surveiller cette tâche à l'aide de la commande suivante.

aws s3control describe-job --account-id 111122223333 --job-id job-id --region source-bucket-region