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.
# Überwachen der Replikation mit Metriken, Ereignisbenachrichtigungen und Status
Sie können Ihre Live-Replikationskonfigurationen und Ihre S3-Batch-Replikationsaufträge mithilfe der folgenden Mechanismen überwachen:
+ **S3-Replikationsmetriken** — Wenn Sie S3-Replikationsmetriken aktivieren, CloudWatch gibt Amazon Metriken aus, mit denen Sie ausstehende Bytes, ausstehende Operationen und Replikationslatenz auf der Ebene der Replikationsregeln verfolgen können. Sie können S3-Replikationsmetriken über die Amazon S3 S3-Konsole und die CloudWatch Amazon-Konsole anzeigen. In der Amazon-S3-Konsole können Sie diese Metriken in der Registerkarte **Metrics** (Metriken) des Quell-Buckets anzeigen. Weitere Informationen zu S3-Replikationsmetriken finden Sie unter [Verwenden von S3-Replikationsmetriken](repl-metrics.md).
+ **S3-Storage-Lens-Metriken** – Zusätzlich zu den S3-Replikationsmetriken können Sie die replikationsbezogenen Datenschutzmetriken verwenden, die in den S3-Storage-Lens-Dashboards bereitgestellt werden. Wenn Sie beispielsweise die kostenlosen Metriken in S3 Storage Lens verwenden, können Sie sich Metriken wie die Gesamtzahl der Byte, die aus dem Quell-Bucket repliziert wurden, oder die Anzahl der replizierten Objekte aus dem Quell-Bucket anzeigen lassen.
Um Ihre allgemeine Position hinsichtlich der Replikation zu überprüfen, können Sie in S3 Storage Lens erweiterte Metriken aktivieren. Mit den erweiterten Metriken in S3 Storage Lens können Sie sehen, über wie viele Replikationsregeln verschiedener Typen Sie verfügen, einschließlich der Anzahl der Replikationsregeln mit einem ungültigen Replikationsziel.
Weitere Informationen zum Arbeiten mit Replikationsmetriken in S3 Storage Lens finden Sie unter [Anzeigen von Replikationsmetriken in den Dashboards in S3 Storage Lens](viewing-replication-metrics-storage-lens.md).
+ **S3-Ereignisbenachrichtigungen** — S3-Ereignisbenachrichtigungen können Sie auf Objektebene benachrichtigen, wenn Objekte nicht an ihr Ziel repliziert werden AWS-Region oder wenn Objekte nicht innerhalb bestimmter Schwellenwerte repliziert werden. S3-Ereignisbenachrichtigungen bieten die folgenden Replikationsereignistypen: `s3:Replication:OperationFailedReplication`, `s3:Replication:OperationMissedThreshold`, `s3:Replication:OperationReplicatedAfterThreshold` und `s3:Replication:OperationNotTracked`.
Amazon S3 S3-Ereignisse sind über Amazon Simple Queue Service (Amazon SQS), Amazon Simple Notification Service (Amazon SNS) oder verfügbar. AWS Lambda Weitere Informationen finden Sie unter [Erhalten von Amazon-S3-Ereignisbenachrichtigungen über Replikations-Fehlerereignisse](replication-metrics-events.md).
+ **Replikationsstatus-Werte** – Sie können auch den Replikationsstatus Ihrer Objekte abrufen. Der Replikationsstatus hilft Ihnen, den aktuellen Status eines Objekts zu bestimmen, das gerade repliziert wird. Der Replikationsstatus eines Quellobjekts gibt entweder `PENDING`, `COMPLETED` oder `FAILED` zurück. Der Replikationsstatus eines Replikats gibt `REPLICA` zurück.
Sie können Replikationsstatus-Werte auch verwenden, wenn Sie S3-Batch-Replikationsaufträge erstellen. Sie können diese Statuswerte beispielsweise verwenden, um Objekte zu replizieren, die entweder nie repliziert wurden oder bei denen die Replikation fehlgeschlagen ist.
Weitere Informationen zum Abrufen des Replikationsstatus Ihrer Objekte finden Sie unter [Abrufen von Replikationsstatusinformationen](replication-status.md). Weitere Informationen zur Verwendung dieser Werte mit der Batch-Replikation finden Sie unter [Filter für einen Batch-Replikationsauftrag](s3-batch-replication-batch.md#batch-replication-filters).
**Topics**
+ [Verwenden von S3-Replikationsmetriken](repl-metrics.md)
+ [Anzeigen von Replikationsmetriken in den Dashboards in S3 Storage Lens](viewing-replication-metrics-storage-lens.md)
+ [Erhalten von Amazon-S3-Ereignisbenachrichtigungen über Replikations-Fehlerereignisse](replication-metrics-events.md)
+ [Abrufen von Replikationsstatusinformationen](replication-status.md)
# Verwenden von S3-Replikationsmetriken
S3-Replikationsmetriken enthalten detaillierte Metriken für die Replikationsregeln in Ihrer Replikationskonfiguration. Mit Replikationsmetriken können Sie den minute-by-minute Fortschritt überwachen, indem Sie ausstehende Bytes, ausstehende Operationen, Operationen, bei denen die Replikation fehlgeschlagen ist, und die Replikationslatenz verfolgen.
**Anmerkung**
S3-Replikationsmetriken werden zum gleichen Tarif wie CloudWatch benutzerdefinierte Amazon-Metriken abgerechnet. Weitere Informationen finden Sie unter [ CloudWatchAmazon-Preise](https://aws.amazon.com/cloudwatch/pricing/).
Wenn Sie S3 Replication Time Control verwenden, CloudWatch beginnt Amazon 15 Minuten, nachdem Sie S3 RTC für die jeweilige Replikationsregel aktiviert haben, mit der Meldung von Replikationsmetriken.
S3-Replikationsmetriken werden automatisch aktiviert, wenn Sie die Funktion für die Begrenzung der S3-Replikationszeit (S3 RTC) aktivieren. Sie können S3-Replikationsmetriken auch unabhängig von S3 RTC aktivieren, während Sie eine [Regel erstellen oder bearbeiten](replication-walkthrough1.md). S3 RTC umfasst weitere Merkmale wie ein Service Level Agreement (SLA) und Benachrichtigungen für nicht eingehaltene Schwellenwerte. Weitere Informationen finden Sie unter [Erfüllen der Compliance-Anforderungen durch eine Begrenzung der S3-Replikationszeit (S3 RTC)](replication-time-control.md).
Wenn S3-Replikationsmetriken aktiviert sind, veröffentlicht Amazon S3 die folgenden Metriken auf Amazon CloudWatch. CloudWatchDie Metriken werden nach bestem Wissen und Gewissen bereitgestellt.
| Metrikname | Metrikbeschreibung | Für welche Objekte gilt diese Metrik? | In welcher Region wird diese Metrik veröffentlicht? | Wird diese Metrik weiterhin veröffentlicht, wenn der Ziel-Bucket gelöscht wird? | Wird diese Metrik weiterhin veröffentlicht, wenn keine Replikation stattfindet? |
| --- | --- | --- | --- | --- | --- |
| **Byte, die noch nicht repliziert wurden** | Die Gesamtanzahl der Bytes von Objekten, deren Replikation für eine bestimmte Replikationsregel aussteht. | Diese Metrik gilt nur für neue Objekte, die mit der regionsübergreifenden S3-Replikation (S3 CRR) oder der regionsinternen S3-Replikation (S3 SRR) repliziert werden. | Diese Metrik wird in der Region des Ziel-Buckets veröffentlicht. | Nein | Ja |
| **Latenz der Replikation** | Die maximale Verzögerung in Sekunden, um die der Replikationsziel-Bucket für eine bestimmte Replikationsregel hinter dem Quell-Bucket zurückliegt. | Diese Metrik gilt nur für neue Objekte, die mit S3 CRR oder S3 SRR repliziert werden. | Diese Metrik wird in der Region des Ziel-Buckets veröffentlicht. | Nein | Ja |
| **Operationen, die noch nicht repliziert wurden** | Die Anzahl an Operationen, deren Replikation für eine bestimmte Replikationsregel aussteht. Diese Metrik verfolgt Vorgänge im Zusammenhang mit Objekten, Löschmarkierungen, Tags, Zugriffskontrolllisten (ACLs) und S3 Object Lock. | Diese Metrik gilt nur für neue Objekte, die mit S3 CRR oder S3 SRR repliziert werden. | Diese Metrik wird in der Region des Ziel-Buckets veröffentlicht. | Nein | Ja |
| **Operationen, die nicht repliziert werden konnten** | Die Anzahl der Operationen, deren Replikation für eine bestimmte Replikationsregel fehlgeschlagen ist. Diese Metrik verfolgt Operationen im Zusammenhang mit Objekten, Löschmarkierungen, Tags, Zugriffskontrolllisten (ACLs) und Object Lock. **Operationen fehlgeschlagen Replikation** verfolgt S3-Replikationsfehler zusammengefasst in einem minütlichen Intervall. Um die spezifischen Objekte zu ermitteln, bei denen die Replikation fehlgeschlagen ist, und die Fehlerursachen herauszufinden, abonnieren Sie das `OperationFailedReplication`-Ereignis in den Amazon-S3-Ereignisbenachrichtigungen. Weitere Informationen finden Sie unter [Erhalten von Amazon-S3-Ereignisbenachrichtigungen über Replikations-Fehlerereignisse](replication-metrics-events.md). | Diese Metrik gilt sowohl für neue Objekte, die mit S3 CRR oder S3 SRR repliziert werden, als auch für vorhandene Objekte, die mit S3-Batch-Replikation repliziert werden. Wenn ein S3-Batch-Replikationsauftrag überhaupt nicht ausgeführt werden kann, werden keine Metriken an Amazon gesendet CloudWatch. Ihr Auftrag wird beispielsweise nicht ausgeführt, wenn Sie nicht über die erforderlichen Berechtigungen verfügen, um einen S3-Batch-Replikationsauftrag auszuführen, oder wenn die Tags oder das Präfix in Ihrer Replikationskonfiguration nicht übereinstimmen. | Diese Metrik wird in der Region des Quell-Buckets veröffentlicht. | Ja | Nein |
Informationen zur Arbeit mit diesen Metriken CloudWatch finden Sie unter[S3-Replikationsmetriken in CloudWatch](metrics-dimensions.md#s3-cloudwatch-replication-metrics).
## Aktivieren von S3-Replikationsmetriken
Sie können S3-Replikationsmetriken mit einer neuen oder einer vorhandenen Replikationsregel verwenden. Alle Informationen zum Erstellen von Replikationsregeln finden Sie unter [Konfigurieren einer Replikation für Buckets im selben Konto](replication-walkthrough1.md). Sie können die Replikationsregel auf einen gesamten S3-Bucket oder auf Amazon-S3-Objekte mit einem bestimmten Präfix oder Tag anwenden.
Dieses Thema enthält Anleitungen zum Aktivieren von S3-Replikationsmetriken in Ihrer Replikationskonfiguration, wenn sich die Quell- und Ziel-Buckets im Eigentum desselben Kontos oder unterschiedlicher AWS-Konten befinden.
Um Replikationsmetriken mithilfe von AWS Command Line Interface (AWS CLI) zu aktivieren, müssen Sie dem Quell-Bucket eine Replikationskonfiguration mit `Metrics` enabled hinzufügen. In dieser Beispielkonfiguration werden Objekte unter dem Präfix `Tax` auf den Ziel-Bucket `amzn-s3-demo-bucket` repliziert und es werden Metriken für diese Objekte generiert.
```
{
"Rules": [
{
"Status": "Enabled",
"Filter": {
"Prefix": "Tax"
},
"Destination": {
"Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
"Metrics": {
"Status": "Enabled"
}
},
"Priority": 1
}
],
"Role": "IAM-Role-ARN"
}
```
## Anzeigen von Replikationsmetriken
Sie können die S3-Replikationsmetriken in der Registerkarte **Metriken** des Allzweck-Buckets in der Amazon-S3-Konsole anzeigen. Diese CloudWatch Amazon-Metriken sind auch in der CloudWatch Amazon-Konsole verfügbar. Wenn Sie S3-Replikationsmetriken aktivieren, CloudWatch gibt Amazon Metriken aus, mit denen Sie ausstehende Bytes, ausstehende Operationen und Replikationslatenz auf der Ebene der Replikationsregeln verfolgen können.
S3-Replikationsmetriken werden automatisch aktiviert, wenn Sie die Replikation mit Begrenzung der S3-Replikationszeit (S3 RTC) über die Amazon-S3-Konsole oder die REST-API von Amazon S3 aktivieren. Sie können S3-Replikationsmetriken auch unabhängig von S3 RTC aktivieren, während Sie eine [Regel erstellen oder bearbeiten](replication-walkthrough1.md).
Wenn Sie S3 Replication Time Control verwenden, CloudWatch beginnt Amazon 15 Minuten, nachdem Sie S3 RTC für die jeweilige Replikationsregel aktiviert haben, mit der Meldung von Replikationsmetriken. Weitere Informationen finden Sie unter [Verwenden von S3-Replikationsmetriken](#repl-metrics).
Replikationsmetriken verfolgen die Regel IDs der Replikationskonfiguration. Eine Replikationsregel-ID kann spezifisch für ein Präfix, ein Tag oder eine Kombination aus beiden sein.
Weitere Informationen zu CloudWatch Metriken für Amazon S3 finden Sie unter[Metriken mit Amazon überwachen CloudWatch](cloudwatch-monitoring.md).
**Voraussetzungen**
Erstellen Sie eine Replikationsregel, für die S3-Replikationsmetriken aktiviert sind. Weitere Informationen finden Sie unter [Aktivieren von S3-Replikationsmetriken](#enabling-replication-metrics).
**So zeigen Sie S3-Replikationsmetriken über die Registerkarte **Metrics** (Metriken) des Quell-Buckets an**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Wählen Sie im linken Navigationsbereich **Allzweck-Buckets** aus.
1. Wählen Sie in der Liste Buckets den Namen des Quell-Buckets mit den Objekten aus, für die Sie Replikationsmetriken abrufen möchten.
1. Wählen Sie die Registerkarte **Metriken** aus.
1. Wählen Sie unter **Replication metrics** (Replikationsmetriken) die Replikationsregeln aus, für die Sie Metriken anzeigen möchten.
1. Wählen Sie **Display charts (Diagramme anzeigen)**.
Amazon S3 zeigt die Diagramme **Replikationslatenz**, **Byte, die noch nicht repliziert wurden** **Operationen, die noch nicht repliziert wurden** und **Operationen, die nicht repliziert werden konnten** an.
# Anzeigen von Replikationsmetriken in den Dashboards in S3 Storage Lens
Zusätzlich zu den [S3-Replikationsmetriken](repl-metrics.md) können Sie die replikationsbezogenen Datenschutzmetriken verwenden, die von S3-Storage Lens bereitgestellt werden. S3 Storage Lens ist eine Cloud-Speicheranalysefunktion, mit der Sie unternehmensweite Einblicke in die Nutzung und Aktivität von Objektspeichern erhalten können. Weitere Informationen finden Sie unter [Verwenden von S3 Storage Lens zum Schutz Ihrer Daten](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-data-protection.html#storage-lens-data-protection-replication-rule).
S3 Storage Lens bietet zwei Metrikebenen: kostenlose Metriken sowie erweiterte Metriken und Empfehlungen, auf die Sie gegen eine zusätzliche Gebühr upgraden können. Mit erweiterten Metriken und Empfehlungen können Sie auf zusätzliche Metriken und Funktionen zugreifen, um Erkenntnisse über Ihren Speicher zu erhalten. Weitere Informationen zu den Preisen für S3 Storage Lens finden Sie unter [Amazon S3-Preise](https://aws.amazon.com/s3/pricing).
Wenn Sie die kostenlosen Metriken in S3 Storage Lens verwenden, können Sie sich Metriken wie die Gesamtzahl der Byte, die aus dem Quell-Bucket repliziert wurden, oder die Anzahl der replizierten Objekte aus dem Quell-Bucket anzeigen lassen.
Um Ihre allgemeine Position hinsichtlich der Replikation zu überprüfen, können Sie in S3 Storage Lens erweiterte Metriken aktivieren. Mit den erweiterten Metriken in S3 Storage Lens können Sie sehen, über wie viele Replikationsregeln verschiedener Typen Sie verfügen, einschließlich der Anzahl der Replikationsregeln mit einem ungültigen Replikationsziel.
Eine vollständige Liste der Metriken in S3 Storage Lens, einschließlich der Replikationsmetriken der einzelnen Ebenen, finden Sie im [Metrikglossar von S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html).
**Voraussetzungen**
Erstellen Sie eine [Live-Replikationskonfiguration](replication-how-setup.md) oder einen [S3-Batch-Replikationsauftrag](s3-batch-replication-batch.md).
**So zeigen Sie Replikationsmetriken in Amazon S3 Storage Lens an**
1. Erstellen Sie ein S3-Storage-Lens-Dashboard. step-by-stepAnweisungen finden Sie unter[Verwenden der S3-Konsole](storage_lens_creating_dashboard.md#storage_lens_console_creating).
1. (Optional) Wenn Sie bei der Einrichtung Ihres Dashboards alle Replikationsmetriken von S3 Storage Lens sehen möchten, wählen Sie **Advanced metrics and recommendations** (Erweiterte Metriken und Empfehlungen) und dann **Advanced data protection metrics** (Erweiterte Datenschutzmetriken) aus. Eine vollständige Liste der Metriken finden Sie im [Metrikglossar von S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html).
Aktivieren Sie erweiterte Metriken und Empfehlungen, um weitere Einblicke in Ihre Replikationskonfigurationen zu erhalten. Sie können beispielsweise die Metriken zur Anzahl der Replikationsregeln von S3 Storage Lens verwenden, um detaillierte Informationen zu Ihren Buckets zu erhalten, die für die Replikation konfiguriert sind. Zu diesen Informationen gehören Replikationsregeln innerhalb von Buckets und Regionen sowie Bucket- und regionsübergreifende Replikationsregeln. Weitere Informationen finden Sie unter [Zählen der Gesamtzahl der Replikationsregeln für jeden Bucket](storage-lens-data-protection.md#storage-lens-data-protection-replication-rule).
1. Nachdem Sie Ihr Dashboard erstellt haben, öffnen Sie das Dashboard und wählen Sie die Registerkarte **Buckets**.
1. Scrollen Sie nach unten zum Abschnitt **Buckets**. Wählen Sie unter **Metrics categories** (Metrikkategorien) die Option **Data protection** (Datenschutz) aus. Löschen Sie dann **Summary** (Zusammenfassung).
1. Wenn Sie die Liste **Buckets** so filtern möchten, dass nur Replikationsmetriken angezeigt werden, wählen Sie das Präferenzsymbol (![\[The preferences icon in the S3 Storage Lens dashboard.\]](http://docs.aws.amazon.com/de_de/AmazonS3/latest/userguide/images/preferences.png)) aus.
1. Deaktivieren Sie die Schalter für alle Datenschutzmetriken, bis nur noch die Replikationsmetriken ausgewählt sind.
1. (Optional) Wählen Sie unter **Page size** (Seitengröße) die Anzahl der Buckets aus, die in der Liste angezeigt werden sollen.
1. Klicken Sie auf **Weiter**.
# Erhalten von Amazon-S3-Ereignisbenachrichtigungen über Replikations-Fehlerereignisse
Wenn Sie S3-Replikationsmetriken in Ihrer Replikationskonfiguration aktiviert haben, können Sie Amazon-S3-Ereignisbenachrichtigungen einrichten, damit Sie benachrichtigt werden, wenn Objekte nicht in ihre Ziel- AWS-Region repliziert werden. Wenn Sie die Begrenzung der S3-Replikationszeit (S3 RTC) in Ihrer Replikationskonfiguration aktiviert haben, können Sie auch benachrichtigt werden, wenn Objekte nicht innerhalb des S3-RTC-Grenzwerts von 15 Minuten repliziert werden.
Mithilfe der folgenden `Replication` Ereignistypen können Sie den minute-by-minute Fortschritt von Replikationsereignissen überwachen, indem Sie ausstehende Byte, ausstehende Vorgänge und die Replikationslatenz verfolgen. Weitere Informationen zu S3-Replikationsmetriken finden Sie unter [Verwenden von S3-Replikationsmetriken](repl-metrics.md).
+ Der `s3:Replication:OperationFailedReplication`-Ereignistyp benachrichtigt Sie, wenn ein Objekt, das für die Replikation berechtigt war, nicht repliziert werden konnte.
+ Der `s3:Replication:OperationMissedThreshold`-Ereignistyp benachrichtigt Sie, wenn ein Objekt, das für die Replikation mit S3 RTC berechtigt war, den 15-minütigen Schwellenwert für die Replikation überschreitet.
+ Der `s3:Replication:OperationReplicatedAfterThreshold`-Ereignistyp benachrichtigt Sie, wenn ein Objekt, das für die Replikation mit S3 RTC in Frage kommt, nach dem 15-Minuten-Schwellenwert repliziert wird.
+ Der `s3:Replication:OperationNotTracked`-Ereignistyp benachrichtigt Sie, wenn ein Objekt, das für die Live-Replikation geeignet war (entweder Same-Region Replication [SRR] oder Cross-Region Replication [CRR]), nicht mehr von Replikationsmetriken verfolgt wird.
Eine vollständige Beschreibung aller unterstützten Replikationsereignistypen finden Sie unter [Unterstützte Ereignistypen für SQS, SNS und Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).
Eine Liste der Fehlercodes, die von S3-Ereignisbenachrichtigungen erfasst werden, finden Sie unter [Gründe für das Fehlschlagen der Replikation in Amazon S3](#replication-failure-codes).
Sie können S3-Ereignisbenachrichtigungen über den Amazon Simple Queue Service (Amazon SQS), den Amazon Simple Notification Service (Amazon SNS) oder AWS Lambda erhalten. Weitere Informationen finden Sie unter [Amazon-S3-Ereignisbenachrichtigungen](EventNotifications.md).
Anweisungen zum Konfigurieren von Amazon-S3-Ereignisbenachrichtigungen finden Sie unter [Aktivieren von Ereignisbenachrichtigungen](how-to-enable-disable-notification-intro.md).
**Anmerkung**
Es empfiehlt sich, nicht nur Ereignisbenachrichtigungen, sondern auch S3-Replikationsmetriken zu aktivieren. Weitere Informationen finden Sie unter [Aktivieren von S3-Replikationsmetriken](repl-metrics.md#enabling-replication-metrics).
Das Folgende ist ein Beispiel für eine Nachricht, die Amazon S3 sendet, um ein `s3:Replication:OperationFailedReplication`-Ereignis zu veröffentlichen. Weitere Informationen finden Sie unter [Struktur von Ereignismeldungen](notification-content-structure.md).
```
{
"Records": [
{
"eventVersion": "2.2",
"eventSource": "aws:s3",
"awsRegion": "us-east-1",
"eventTime": "2024-09-05T21:04:32.527Z",
"eventName": "Replication:OperationFailedReplication",
"userIdentity": {
"principalId": "s3.amazonaws.com"
},
"requestParameters": {
"sourceIPAddress": "s3.amazonaws.com"
},
"responseElements": {
"x-amz-request-id": "123bf045-2b4b-4ca8-a211-c34a63c59426",
"x-amz-id-2": "12VAWNDIHnwJsRhTccqQTeAPoXQmRt22KkewMV8G3XZihAuf9CLDdmkApgZzudaIe2KlLfDqGS0="
},
"s3": {
"s3SchemaVersion": "1.0",
"configurationId": "ReplicationEventName",
"bucket": {
"name": "amzn-s3-demo-bucket1",
"ownerIdentity": {
"principalId": "111122223333"
},
"arn": "arn:aws:s3:::amzn-s3-demo-bucket1"
},
"object": {
"key": "replication-object-put-test.png",
"size": 520080,
"eTag": "e12345ca7e88a38428305d3ff7fcb99f",
"versionId": "abcdeH0Xp66ep__QDjR76LK7Gc9X4wKO",
"sequencer": "0066DA1CBF104C0D51"
}
},
"replicationEventData": {
"replicationRuleId": "notification-test-replication-rule",
"destinationBucket": "arn:aws:s3:::amzn-s3-demo-bucket2",
"s3Operation": "OBJECT_PUT",
"requestTime": "2024-09-05T21:03:59.168Z",
"failureReason": "AssumeRoleNotPermitted"
}
}
]
}
```
## Gründe für das Fehlschlagen der Replikation in Amazon S3
Die folgende Tabelle enthält Gründe für das Fehlschlagen der Replikation in Amazon S3. Sie können diese Gründe anzeigen, indem Sie das Ereignis `s3:Replication:OperationFailedReplication` mit den Amazon-S3-Ereignisbenachrichtigungen erhalten und sich den Wert `failureReason` ansehen.
Sie können diese Fehlergründe auch in einem Abschlussbericht der S3-Batch-Replikation anzeigen. Weitere Informationen finden Sie unter [Abschlussbericht zur Batchreplikation](s3-batch-replication-batch.md#batch-replication-completion-report).
| Gründe für das Fehlschlagen der Replikation | Description |
| --- | --- |
| `AssumeRoleNotPermitted` | Amazon S3 kann die AWS Identity and Access Management (IAM-) Rolle nicht übernehmen, die in der Replikationskonfiguration oder im Batch Operations-Job angegeben ist. |
| `DstBucketInvalidRegion` | Der Ziel-Bucket befindet sich nicht in demselben AWS-Region Bucket, der im Batch Operations-Job angegeben wurde. Dieser Fehler ist spezifisch für die Batchreplikation. |
| `DstBucketNotFound` | Amazon S3 kann den in der Replikationskonfiguration angegebenen Ziel-Bucket nicht finden. |
| `DstBucketObjectLockConfigMissing` | Um Objekte aus einem Quell-Bucket mit aktivierter Objektsperre zu replizieren, muss für den Ziel-Bucket ebenfalls die Objektsperre aktiviert sein. Dieser Fehler zeigt an, dass die Objektsperre im Ziel-Bucket möglicherweise nicht aktiviert ist. Weitere Informationen finden Sie unter [Überlegungen zu Object Lock](object-lock-managing.md). |
| `DstBucketUnversioned` | Die Versionsverwaltung ist für den S3-Ziel-Bucket nicht aktiviert. Aktivieren Sie die Versionsverwaltung für den Ziel-Bucket, um Objekte mit S3-Replikation zu replizieren. |
| `DstDelObjNotPermitted` | Amazon S3 kann Löschmarkierungen nicht in den angegebenen Ziel-Bucket replizieren. Möglicherweise fehlt die `s3:ReplicateDelete`-Berechtigung für den Ziel-Bucket. |
| `DstKmsKeyInvalidState` | Der Schlüssel AWS Key Management Service (AWS KMS) für den Ziel-Bucket ist nicht gültig. Überprüfen und aktivieren Sie den erforderlichen AWS KMS Schlüssel. Weitere Informationen zur Verwaltung von AWS KMS Schlüsseln finden Sie unter [Schlüsselstatus von AWS KMS Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) im *AWS Key Management Service Entwicklerhandbuch*. |
| `DstKmsKeyNotFound` | Der AWS KMS Schlüssel, der in der Replikationskonfiguration für den Ziel-Bucket konfiguriert ist, ist nicht vorhanden. |
| `DstMultipartCompleteNotPermitted` | Amazon S3 kann mehrteilige Uploads von Objekten im Ziel-Bucket nicht abschließen. Möglicherweise fehlt die `s3:ReplicateObject`-Berechtigung für den Ziel-Bucket. |
| `DstMultipartInitNotPermitted` | Amazon S3 kann mehrteilige Uploads von Objekten in den Ziel-Bucket nicht initiieren. Möglicherweise fehlt die `s3:ReplicateObject`-Berechtigung für den Ziel-Bucket. |
| `DstMultipartUploadNotPermitted` | Amazon S3 kann keine mehrteiligen Upload-Objekte in den Ziel-Bucket hochladen. Möglicherweise fehlt die `s3:ReplicateObject`-Berechtigung für den Ziel-Bucket. |
| `DstObjectHardDeleted` | Die S3-Batchreplikation unterstützt nicht das erneute Replizieren von Objekten, die mit der Versions-ID des Objekts aus dem Ziel-Bucket gelöscht wurden. Dieser Fehler ist spezifisch für die Batchreplikation. |
| `DstPutAclNotPermitted` | Amazon S3 ist nicht in der Lage, Objektzugriffskontrolllisten (ACLs) in den Ziel-Bucket zu replizieren. Möglicherweise fehlt die `s3:ReplicateObject`-Berechtigung für den Ziel-Bucket. |
| `DstPutLegalHoldNotPermitted` | Amazon S3 kann keine Object Lock aufgrund gesetzlicher Aufbewahrungsfristen für die Zielobjekte festlegen, während unveränderliche Objekte repliziert werden. Möglicherweise fehlt die `s3:PutObjectLegalHold`-Berechtigung für den Ziel-Bucket. Weitere Informationen finden Sie unter [Rechtliche Aufbewahrungsfristen](object-lock.md#object-lock-legal-holds). |
| `DstPutObjectNotPermitted` | Amazon S3 kann Objekte nicht in den angegebenen Ziel-Bucket replizieren. Dies kann der Fall sein, wenn die erforderlichen Berechtigungen (`s3:ReplicateObject`oder `s3:ObjectOwnerOverrideToBucketOwner` Berechtigungen) für den Ziel-Bucket fehlen oder wenn die AWS KMS Schlüsselrichtlinie es der Replikationsrolle des Quell-Buckets nicht erlaubt, den AWS KMS Schlüssel (`kms:Decrypt`und die `kms:GenerateDataKey*` Aktionen) im Ziel-Bucket zu verwenden. |
| `DstPutRetentionNotPermitted` | Amazon S3 kann bei der Replikation unveränderlicher Objekte keine Aufbewahrungsfrist für die Zielobjekte festlegen. Möglicherweise fehlt die `s3:PutObjectRetention`-Berechtigung für den Ziel-Bucket. |
| `DstPutTaggingNotPermitted` | Amazon S3 kann Objekt-Tags nicht in den angegebenen Ziel-Bucket replizieren. Möglicherweise fehlt die `s3:ReplicateObject`-Berechtigung für den Ziel-Bucket. |
| `DstVersionNotFound ` | Amazon S3 kann die erforderliche Objektversion im Ziel-Bucket nicht finden, für den Metadaten repliziert werden müssen. |
| `InitiateReplicationNotPermitted` | Amazon S3 kann keine Replikation für Objekte initiieren. Möglicherweise fehlt die `s3:InitiateReplication`-Berechtigung für den Batch-Operationsauftrag. Dieser Fehler ist spezifisch für die Batchreplikation. |
| `SrcBucketInvalidRegion` | Der Quell-Bucket befindet sich nicht in demselben AWS-Region Bucket, der im Batch Operations-Job angegeben wurde. Dieser Fehler ist spezifisch für die Batchreplikation. |
| `SrcBucketNotFound` | Amazon S3 kann den Quell-Bucket nicht finden. |
| `SrcBucketReplicationConfigMissing` | Amazon S3 konnte keine Replikationskonfiguration für den Quell-Bucket finden. |
| `SrcGetAclNotPermitted` | Amazon S3 kann nicht auf das Objekt im Quell-Bucket für die Replikation zugreifen. Möglicherweise fehlt die `s3:GetObjectVersionAcl`-Berechtigung für das Quell-Bucket-Objekt. Die Objekte im Quell-Bucket müssen sich im Besitz des Bucket-Eigentümers befinden. Wenn aktiviert ACLs sind, überprüfen Sie, ob „Objekteigentum“ auf „Bucket-Besitzer bevorzugt“ oder „Objekt-Writer“ gesetzt ist. Wenn die Objekteigentümerschaft auf Bucket-Eigentümer bevorzugt festgelegt ist, müssen die Quell-Bucket-Objekte über die ACL `bucket-owner-full-control` verfügen, damit der Bucket-Eigentümer zum Objekteigentümer wird. Das Quellkonto kann das Eigentum an allen Objekten in seinem Bucket übernehmen, indem die Option Objekteigentum auf Bucket owner erforced gesetzt und deaktiviert wird ACLs. |
| `SrcGetLegalHoldNotPermitted` | Amazon S3 kann nicht auf die Informationen zur gesetzlichen Aufbewahrung von S3 Object Lock zugreifen. |
| `SrcGetObjectNotPermitted` | Amazon S3 kann nicht auf das Objekt im Quell-Bucket für die Replikation zugreifen. Möglicherweise fehlt die `s3:GetObjectVersionForReplication`-Berechtigung für den Quell-Bucket. |
| `SrcGetRetentionNotPermitted` | Amazon S3 kann nicht auf die Informationen zum Aufbewahrungszeitraum von S3 Object Lock zugreifen. |
| `SrcGetTaggingNotPermitted` | Amazon S3 kann nicht auf Objekt-Tag-Informationen aus dem Quell-Bucket zugreifen. Möglicherweise fehlt die `s3:GetObjectVersionTagging`-Berechtigung für den Quell-Bucket. |
| `SrcHeadObjectNotPermitted` | Amazon S3 kann keine Objektmetadaten aus dem Quell-Bucket abrufen. Möglicherweise fehlt die `s3:GetObjectVersionForReplication`-Berechtigung für den Quell-Bucket. |
| `SrcKeyNotFound` | Amazon S3 kann den Quellobjektschlüssel für die Replikation nicht finden. Das Quellobjekt wurde möglicherweise gelöscht, bevor die Replikation abgeschlossen war. |
| `SrcKmsKeyInvalidState` | Der AWS KMS Schlüssel für den Quell-Bucket hat keinen gültigen Status. Überprüfen und aktivieren Sie den erforderlichen AWS KMS Schlüssel. Weitere Informationen zur Verwaltung von AWS KMS Schlüsseln finden Sie unter [Schlüsselstatus von AWS KMS Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) im *AWS Key Management Service Entwicklerhandbuch*. |
| `SrcObjectNotEligible` | Einige Objekte kommen nicht für die Replikation infrage. Dies kann an der Speicherklasse des Objekts liegen oder daran, dass die Objekt-Tags nicht mit der Replikationskonfiguration übereinstimmen. |
| `SrcObjectNotFound` | Das Quellobjekt ist nicht vorhanden. |
| `SrcReplicationNotPending` | Amazon S3 hat dieses Objekt bereits repliziert. Für dieses Objekt steht keine Replikation mehr aus. |
| `SrcVersionNotFound` | Amazon S3 kann den Quellobjektversion für die Replikation nicht finden. Die Quellobjektversion wurde möglicherweise gelöscht, bevor die Replikation abgeschlossen war. |
### Verwandte Themen
[Einrichten von Berechtigungen für die Live-Replikation](setting-repl-config-perm-overview.md)
[Fehlerbehebung bei einer Replikation](replication-troubleshoot.md)
# Abrufen von Replikationsstatusinformationen
Der Replikationsstatus hilft Ihnen, den aktuellen Status eines derzeit replizierten Objekts zu bestimmen. Der Replikationsstatus eines Quellobjekts gibt entweder `PENDING`, `COMPLETED` oder `FAILED` zurück. Der Replikationsstatus eines Replikats gibt `REPLICA` zurück.
Sie können Replikationsstatus-Werte auch verwenden, wenn Sie S3-Batch-Replikationsaufträge erstellen. Sie können diese Statuswerte beispielsweise verwenden, um Objekte zu replizieren, die entweder nie repliziert wurden oder bei denen die Replikation fehlgeschlagen ist. Weitere Informationen zur Verwendung dieser Werte mit der Batch-Replikation finden Sie unter [Verwenden von Replikationsstatusinformationen mit Batch-Replikationsaufträgen](#replication-status-batch-replication).
**Topics**
+ [Übersicht über den Replikationsstatus](#replication-status-overview)
+ [Replikationsstatus bei einer Replikation auf mehrere Ziel-Buckets](#replication-status-multiple-destinations)
+ [Replikationsstatus, wenn die Synchronisierung von Amazon-S3-Replikatänderungen aktiviert ist](#replication-status-replica-mod-syn)
+ [Verwenden von Replikationsstatusinformationen mit Batch-Replikationsaufträgen](#replication-status-batch-replication)
+ [Finden des Replikationsstatus](#replication-status-usage)
## Übersicht über den Replikationsstatus
Bei der Replikation haben Sie einen Quell-Bucket, auf dem die Replikation konfiguriert wird, und einen oder mehrere Ziel-Buckets, in die Amazon S3 Objekte repliziert. Wenn Sie ein Objekt (mit `GetObject`) oder Objektmetadaten (mit `HeadObject`) von diesen Buckets anfordern, gibt Amazon S3 den Header `x-amz-replication-status` wie folgt in der Antwort zurück:
+ Wenn Sie ein Objekt aus dem Quell-Bucket anfordern, gibt Amazon S3 den Header `x-amz-replication-status` zurück, wenn das Objekt in der Anforderung für die Replikation geeignet ist.
Nehmen wir beispielsweise an, dass Sie in Ihrer Replikationskonfiguration das Objektpräfix `TaxDocs` angeben, um Amazon S3 anzuweisen, nur Objekte mit dem Schlüsselnamenpräfix `TaxDocs` zu replizieren. Alle Objekte mit diesem Schlüsselnamenpräfix, die Sie hochladen, z. B. `TaxDocs/document1.pdf`, werden repliziert. Für Objektanforderungen mit diesem Schlüsselnamenpräfix gibt Amazon S3 den Header `x-amz-replication-status` mit einem der folgenden Werte für den Replikationsstatus des Objekts zurück: `PENDING`, `COMPLETED` oder `FAILED`.
**Anmerkung**
Wenn nach dem Hochladen eines Objekts die Objektreplikation fehlschlägt, können Sie die fehlgeschlagene Replikation nicht erneut durchzuführen versuchen. Sie müssen das Objekt erneut hochladen, oder Sie müssen die S3-Batch-Replikation verwenden, um alle fehlgeschlagenen Objekte zu replizieren. S3 Lifecycle blockiert Ablauf- und Übergangsaktionen für Objekte mit `PENDING` oder ohne `FAILED` Replikationsstatus. Weitere Informationen zur Verwendung der Batch-Replikation finden Sie unter [Replizieren vorhandener Objekte mit der Batch-Replikation](s3-batch-replication-batch.md).
Objekte werden aufgrund von Problemen wie fehlenden Berechtigungen für Replikationsrollen, AWS Key Management Service (AWS KMS) -Berechtigungen oder Bucket-Berechtigungen in einen bestimmten `FAILED` Status versetzt. Bei temporären Fehlern, z. B. wenn ein Bucket oder eine Region nicht verfügbar ist, geht der Replikationsstatus nicht in `FAILED` über, sondern verbleibt bei `PENDING`. Wenn die Ressource wieder online ist, setzt Amazon S3 die Replikation dieser Objekte fort.
+ Wenn Sie ein Objekt aus einem Ziel-Bucket anfordern und es sich bei dem Objekt Ihrer Anforderung um ein Replikat handelt, das Amazon S3 erstellt hat, gibt Amazon S3 den Header `x-amz-replication-status` mit dem Wert `REPLICA` zurück.
**Anmerkung**
Bevor Sie ein Objekt aus einem Quell-Bucket löschen, bei dem die Replikation aktiviert ist, sollten Sie den Replikationsstatus des Objekts überprüfen, um sicherzustellen, dass das Objekt repliziert wurde.
Wenn eine S3-Lifecycle-Konfiguration im Quell-Bucket aktiviert ist, setzt Amazon S3 Lebenszyklusaktionen aus, bis der Replikationsstatus des Objekts als `COMPLETED` markiert wird. Wenn der Replikationsstatus lautet`FAILED`, blockiert S3 Lifecycle weiterhin Ablauf- und Übergangsaktionen für das Objekt, bis Sie das zugrunde liegende Replikationsproblem behoben haben. Weitere Informationen finden Sie unter [S3-Lebenszyklus und](lifecycle-and-other-bucket-config.md#lifecycle-and-replication).
## Replikationsstatus bei einer Replikation auf mehrere Ziel-Buckets
Wenn Sie Objekte in mehrere Ziel-Buckets replizieren, verhält sich der Header `x-amz-replication-status` anders. Der Header des Quellobjekts gibt den Wert `COMPLETED` nur zurück, wenn die Replikation in alle Ziele erfolgreich ist. Der Header bleibt auf dem Wert `PENDING`, bis die Replikation für alle Ziele abgeschlossen ist. Wenn die Replikation bei einem oder mehreren Zielen fehlschlägt, liefert der Header `FAILED`.
## Replikationsstatus, wenn die Synchronisierung von Amazon-S3-Replikatänderungen aktiviert ist
Wenn in Ihren Replikationsregeln die Synchronisierung von Amazon-S3-Replikatänderungen aktiviert ist, können Replikate einen anderen Status als `REPLICA` melden. Wenn Änderungen an Metadaten gerade repliziert werden, gibt der `x-amz-replication-status`-Header den Wert `PENDING` zurück. Wenn die Synchronisierung der Replikatänderung Metadaten nicht repliziert, gibt der Header `FAILED` zurück. Wenn Metadaten korrekt repliziert werden, geben die Replikate den Header `REPLICA` zurück.
## Verwenden von Replikationsstatusinformationen mit Batch-Replikationsaufträgen
Wenn Sie einen Batch-Replikationsauftrag erstellen, können Sie optional zusätzliche Filter angeben, z. B. das Erstellungsdatum des Objekts und den Replikationsstatus, um den Umfang des Auftrags zu reduzieren.
Sie können Objekte filtern, die repliziert werden sollen, basierend auf dem `ObjectReplicationStatuses`-Wert, indem Sie einen oder mehrere der folgenden Werte angeben:
+ `"NONE"` – Zeigt an, dass Amazon S3 noch nie versucht hat, das Objekt zu replizieren.
+ `"FAILED"` – Zeigt an, dass Amazon S3 versucht hat, das Objekt zu replizieren, es jedoch zuvor nicht replizieren konnte.
+ `"COMPLETED"` – Zeigt an, dass Amazon S3 das Objekt zuvor erfolgreich repliziert hat.
+ `"REPLICA"` – Zeigt an, dass dies ein Replikatobjekt ist, das Amazon S3 von einer anderen Quelle repliziert hat.
Weitere Informationen zur Verwendung dieser Replikationsstatus-Werte mit der Batch-Replikation finden Sie unter [Filter für einen Batch-Replikationsauftrag](s3-batch-replication-batch.md#batch-replication-filters).
## Finden des Replikationsstatus
Verwenden Sie das Amazon-S3-Inventory-Tool, um den Replikationsstatus der Objekte in einem Bucket abzurufen. Amazon S3 sendet eine CSV-Datei an den Ziel-Bucket, den Sie in der Bestands-Konfiguration angeben. Sie können auch Amazon Athena verwenden, um den Replikationsstatus im Bestandsbericht abzufragen. Weitere Informationen zu Amazon S3 Inventory finden Sie unter [Katalogisieren und Analysieren Ihrer Daten mit S3 Inventory](storage-inventory.md).
Sie können den Status der Objektreplikation auch mithilfe der Amazon S3 S3-Konsole, des AWS Command Line Interface (AWS CLI) oder des AWS SDK ermitteln.
### Verwenden der S3-Konsole
In der Amazon-S3-Konsole können Sie den Replikationsstatus für ein Objekt auf seiner Detailseite anzeigen.
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Wählen Sie im linken Navigationsbereich **Buckets** aus.
1. Wählen Sie in der Liste der **Allzweck-Buckets** den Namen des Quell-Buckets der Replikation aus.
1. Wählen Sie in der Liste **Objekte** den Objektnamen aus. Die Seite mit den Objektdetails wird angezeigt.
1. Scrollen Sie auf der Registerkarte **Properties (Eigenschaften)** nach unten zum Abschnitt **Object management overview (Objektverwaltung – Übersicht)**. Beachten Sie unter **Management configurations (Verwaltungskonfigurationen)** den Wert unter **Replication status (Replikationsstatus)**.
### Verwenden Sie den AWS CLI
Verwenden Sie den `head-object` Befehl AWS Command Line Interface (AWS CLI), um Objektmetadaten abzurufen, wie im folgenden Beispiel gezeigt. Ersetzen Sie den `amzn-s3-demo-source-bucket1` durch den Namen Ihres Quell-Buckets der Replikation und die anderen `user input placeholders` durch Ihre eigenen Informationen.
```
aws s3api head-object --bucket amzn-s3-demo-source-bucket1 --key object-key --version-id object-version-id
```
Der Befehl gibt Informationen zu Objektmetadaten, einschließlich des `ReplicationStatus`, zurück, wie in der folgenden Beispielantwort dargestellt:
```
{
"AcceptRanges":"bytes",
"ContentType":"image/jpeg",
"LastModified":"Mon, 23 Mar 2015 21:02:29 GMT",
"ContentLength":3191,
"ReplicationStatus":"COMPLETED",
"VersionId":"jfnW.HIMOfYiD_9rGbSkmroXsFj3fqZ.",
"ETag":"\"6805f2cfc46c0f04559748bb039d69ae\"",
"Metadata":{
}
}
```
### Verwenden Sie den AWS SDKs
Die folgenden Codefragmente ermitteln Ihren Replikationsstatus mithilfe von AWS SDK für Java und AWS SDK für .NET.
------
#### [ Java ]
```
GetObjectMetadataRequest metadataRequest = new GetObjectMetadataRequest(bucketName, key);
ObjectMetadata metadata = s3Client.getObjectMetadata(metadataRequest);
System.out.println("Replication Status : " + metadata.getRawMetadataValue(Headers.OBJECT_REPLICATION_STATUS));
```
------
#### [ .NET ]
```
GetObjectMetadataRequest getmetadataRequest = new GetObjectMetadataRequest
{
BucketName = sourceBucket,
Key = objectKey
};
GetObjectMetadataResponse getmetadataResponse = client.GetObjectMetadata(getmetadataRequest);
Console.WriteLine("Object replication status: {0}", getmetadataResponse.ReplicationStatus);
```
------