Erstellen eines Batch-Replikationsauftrags für vorhandene Replikationsregeln - Amazon Simple Storage Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen eines Batch-Replikationsauftrags für vorhandene Replikationsregeln

In Amazon S3 repliziert die Live-Replikation keine Objekte, die bereits in Ihrem Quell-Bucket vorhanden waren, bevor Sie eine Replikationskonfiguration erstellt haben. Bei der Live-Replikation werden automatisch nur neue und aktualisierte Objekte repliziert, die nach der Erstellung der Replikationskonfiguration in den Bucket geschrieben wurden. Um bereits vorhandene Objekte zu replizieren, können Sie S3 Batch Replication verwenden, um diese Objekte bei Bedarf zu replizieren.

Sie können S3 Batch Replication für eine bestehende Replikationskonfiguration konfigurieren, indem Sie die AWS SDKs, AWS Command Line Interface (AWS CLI) oder die Amazon S3 S3-Konsole verwenden. Einen Überblick über die Batch-Replikation finden Sie unterReplizieren vorhandener Objekte mit Batch Replication.

Wenn der Batch-Replikationsauftrag abgeschlossen ist, erhalten Sie einen Abschlussbericht. Weitere Informationen dazu, wie Sie den Bericht verwenden können, um den Auftrag zu untersuchen, finden Sie unter Verfolgen von Auftragsstatus- und Abschluss.

Voraussetzungen

Bevor Sie Ihren Batch Replication-Job erstellen, müssen Sie eine Batch Operations AWS Identity and Access Management (IAM) -Rolle erstellen, um Amazon S3 Berechtigungen zur Ausführung von Aktionen in Ihrem Namen zu erteilen. Weitere Informationen finden Sie unter Konfiguration einer IAM Rolle für die S3-Batch-Replikation.

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/.

  2. Klicken Sie im linken Navigationsbereich auf Batchvorgänge.

  3. Wählen Sie Job erstellen aus.

  4. Vergewissern Sie sich, dass im AWS-RegionAbschnitt die Region angezeigt wird, in der Sie Ihren Job erstellen möchten.

  5. Geben Sie im Abschnitt Manifest das Manifestformat an, das Sie verwenden möchten. Das Manifest ist eine Liste aller Objekte, für die die festgelegte Aktion ausgeführt werden soll. Weitere Informationen über die Batchvorgangs-Manifeste finden Sie unter Angeben eines Manifests.

    • Wenn Sie ein Manifest vorbereitet haben, wählen Sie S3-Inventarbericht (manifest.json) oder. CSV Wenn sich Ihr Manifest in einem versionierten Bucket befindet, können Sie die Versions-ID für das Manifest angeben. Wenn Sie keine Versions-ID angeben, verwendet Batch Operations die aktuelle Version Ihres Manifests. Weitere Informationen zum Erstellen eines Manifests finden Sie unterAngeben eines Manifests.

      Anmerkung

      Wenn sich die Objekte in Ihrem Manifest in einem versionierten Bucket befinden, müssen Sie die Version IDs für die Objekte angeben. Weitere Informationen finden Sie unter Angeben eines Manifests.

    • Um ein Manifest basierend auf Ihrer Replikationskonfiguration zu erstellen, wählen Sie Create manifest using S3 Replication configuration (Manifest mit der S3-Replikationskonfiguration erstellen). Wählen Sie dann den Quell-Bucket Ihrer Replikationskonfiguration aus.

  6. (Optional) Wenn Sie „Manifest mithilfe der S3-Replikationskonfiguration erstellen“ ausgewählt haben, können Sie zusätzliche Filter hinzufügen, z. B. das Erstellungsdatum des Objekts und den Replikationsstatus. Beispiele dafür, wie Sie nach dem Replikationsstatus filtern können, finden Sie unterAngeben eines Manifests für einen Batch-Replikationsauftrag.

  7. (Optional) Wenn Sie „Manifest mithilfe der S3-Replikationskonfiguration erstellen“ ausgewählt haben, können Sie das generierte Manifest speichern. Um dieses Manifest zu speichern, wählen Sie Batch Operations-Manifest speichern. Geben Sie dann den Ziel-Bucket für das Manifest an und wählen Sie aus, ob das Manifest verschlüsselt werden soll.

    Anmerkung

    Das generierte Manifest muss im selben Ordner AWS-Region wie der Quell-Bucket gespeichert werden.

  8. Wählen Sie Weiter.

  9. Wählen Sie auf der Seite „Vorgänge“ die Option „Replizieren“ und anschließend „Weiter“.

  10. (Optional) Geben Sie eine Beschreibung ein.

  11. Passen Sie die Priority (Priorität) des Auftrags bei Bedarf an. Höhere Nummern bedeuten eine höhere Priorität. Amazon S3 versucht, Aufträge mit höherer Priorität vor Aufträgen mit niedrigerer Priorität auszuführen. Weitere Informationen zur Auftragspriorität finden Sie unter Zuweisen der Auftragspriorität.

  12. (Optional) Generieren Sie einen Abschlussbericht. Um diesen Bericht zu generieren, wählen Sie Abschlussbericht erstellen aus.

    Wenn Sie einen Abschlussbericht erstellen möchten, müssen Sie entweder die Meldung von Failed tasks only (Nur fehlgeschlagenen Aufgaben) oder All tasks (Allen Aufgaben) auswählen und einen Ziel-Bucket für den Bericht angeben.

  13. Stellen Sie sicher, dass Sie im Abschnitt Berechtigungen eine IAM Rolle auswählen, die über die erforderlichen Berechtigungen für die Batch-Replikation verfügt. Eine der häufigsten Ursachen für Replikationsfehler sind unzureichende Berechtigungen in der angegebenen IAM Rolle. Weitere Informationen zum Erstellen dieser Rolle finden Sie unter Konfiguration einer IAM Rolle für die S3-Batch-Replikation.

  14. (Optional) Fügen Sie Auftrags-Tags zum Batch-Replikationsauftrag hinzu.

  15. Wählen Sie Weiter.

  16. Überprüfen Sie Ihre Job-Konfiguration und wählen Sie dann Create Job aus.

Der folgende create-job Beispielbefehl erstellt einen S3-Batch-Replikationsauftrag unter Verwendung eines von S3 generierten Manifests für AWS-Konto 111122223333. In diesem Beispiel werden vorhandene Objekte und Objekte repliziert, die zuvor nicht repliziert werden konnten. Hinweise zum Filtern nach Replikationsstatus finden Sie unter. Angeben eines Manifests für einen Batch-Replikationsauftrag

Um diesen Befehl zu verwenden, ersetzen Sie den Platzhalter für Benutzereingaben mit Ihren eigenen Informationen. Ersetzen Sie die IAM Rolle role/batch-Replication-IAM-policy durch die IAM Rolle, die Sie zuvor erstellt haben. Weitere Informationen finden Sie unter Konfiguration einer IAM Rolle für die S3-Batch-Replikation.

aws s3control create-job --account-id 111122223333 \ 
--operation '{"S3ReplicateObject":{}}' \ 
--report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket",\ 
"Prefix":"batch-replication-report", \ 
"Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \ 
--manifest-generator '{"S3JobManifestGenerator": {"ExpectedBucketOwner": "111122223333", \ 
"SourceBucket": "arn:aws:s3:::amzn-s3-demo-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
Anmerkung

Sie müssen den Job aus demselben Bucket initiieren AWS-Region wie der Replizierungsquellen-Bucket.

Nachdem Sie einen Batch-Replikationsauftrag erfolgreich initiiert haben, erhalten Sie die Auftrags-ID als Antwort. Sie können diesen Job mit dem folgenden describe-job Befehl überwachen. Um diesen Befehl zu verwenden, ersetzen Sie den Platzhalter für Benutzereingaben mit Ihren eigenen Informationen. 

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

Im folgenden Beispiel wird ein S3-Batch-Replikationsauftrag mithilfe eines benutzerdefinierten Manifests für AWS-Konto 111122223333 erstellt. Wenn sich die Objekte in Ihrem Manifest in einem versionierten Bucket befinden, müssen Sie die Version IDs für die Objekte angeben. Es wird nur das Objekt mit der im Manifest angegebenen Versions-ID repliziert. Weitere Informationen zum Erstellen eines Manifests finden Sie unterAngeben eines Manifests.

Um diesen Befehl zu verwenden, ersetzen Sie den Platzhalter für Benutzereingaben mit Ihren eigenen Informationen. Ersetzen Sie die IAM Rolle role/batch-Replication-IAM-policy durch die IAM Rolle, die Sie zuvor erstellt haben. Weitere Informationen finden Sie unter Konfiguration einer IAM Rolle für die S3-Batch-Replikation.

aws s3control create-job --account-id 111122223333 \ 
--operation '{"S3ReplicateObject":{}}' \
--report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-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:::amzn-s3-demo-manifest-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
Anmerkung

Sie müssen den Job aus demselben Bucket initiieren AWS-Region wie der Replizierungsquellen-Bucket.

Nachdem Sie einen Batch-Replikationsauftrag erfolgreich initiiert haben, erhalten Sie die Auftrags-ID als Antwort. Sie können diesen Job mit dem folgenden describe-job Befehl überwachen.

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