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. Die Live-Replikation repliziert automatisch nur neue und aktualisierte Objekte, die nach der Erstellung der Replikationskonfiguration in den Bucket geschrieben wurden. Wenn Sie bereits vorhandene Objekte replizieren möchten, können Sie die S3-Batch-Replikation 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. Eine Übersicht über die Batch-Replikation finden Sie unter Replizieren vorhandener Objekte mit der Batch-Replikation.

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 Batchvorgangs-Auftrag erstellen, müssen Sie eine AWS Identity and Access Management (IAM)-Rolle für Batchvorgänge erstellen, um Amazon S3 Berechtigungen zum Ausführen von Aktionen in Ihrem Namen zu erteilen. Weitere Informationen finden Sie unter Konfigurieren 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. Stellen Sie sicher, dass im Abschnitt AWS-Region die Region angezeigt wird, in der Sie Ihren Auftrag 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 inventory report (manifest.json) (S3 Bestandsbericht) oder CSV aus. 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, verwenden Batch-Operationen die aktuelle Version Ihres Manifests. Weitere Informationen zum Erstellen eines Manifests finden Sie unter Angeben 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 Create manifest using S3 Replication configuration (Manifest mit 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 zum Filtern nach Replikationsstatus finden Sie unter Angeben eines Manifests für einen Batch-Replikationsauftrag.

  7. (Optional) Wenn Sie Create manifest using S3 Replication configuration (Manifest mit der S3-Replikationskonfiguration erstellen) ausgewählt haben, können Sie das generierte Manifest speichern. Um dieses Manifest zu speichern, wählen Sie Save Batch Operations manifest (Manifest für Batchvorgänge 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 Verzeichnis AWS-Region wie der Quell-Bucket gespeichert werden.

  8. Wählen Sie Weiter aus.

  9. Wählen Sie auf der Seite Operations (Vorgänge) die Option Replicate (Replizieren) und anschließend Next (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. Wählen Sie zum Generieren dieses Berichts Generate completion report (Abschlussbericht generieren).

    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 Permissions (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 bereitgestellten IAM-Rolle. Weitere Informationen zum Erstellen dieser Rolle finden Sie unter Konfigurieren 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 aus.

  16. Überprüfen Sie Ihre Auftrags-Konfiguration und wählen Sie dann Create job (Auftrag erstellen).

Im folgenden Beispiel erstellt der Befehl create-job einen S3-Batch-Replikationsauftrag unter Verwendung eines S3-generierten Manifests für das AWS-Konto 111122223333. In diesem Beispiel werden vorhandene Objekte repliziert sowie Objekte, die zuvor nicht repliziert werden konnten. Informationen zum Filtern nach Replikationsstatus finden Sie unter Angeben eines Manifests für einen Batch-Replikationsauftrag.

Zur Verwendung dieses Befehls ersetzen Sie user input placeholders durch eigene 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 Konfigurieren 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 Auftrag mit dem folgenden describe-job-Befehl überwachen. Zur Verwendung dieses Befehls ersetzen Sie user input placeholders durch eigene Informationen. 

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

Im folgenden Beispiel wird ein S3-Batch-Replikationsauftrag unter Verwendung eines benutzerdefinierten Manifest für das 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 unter Angeben eines Manifests.

Zur Verwendung dieses Befehls ersetzen Sie user input placeholders durch eigene 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 Konfigurieren 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 Auftrag mit dem folgenden describe-job-Befehl überwachen.

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