

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.

# Archivierung und Wiedergabe von Amazon SNS SNS-Nachrichten für FIFO-Themen
<a name="fifo-message-archiving-replay"></a>

## Was ist die Nachrichtenarchivierung und -wiederholung?
<a name="what-is-message-archiving-and-replay"></a>

Amazon SNS bietet eine Funktion zur Archivierung und Wiedergabe von Nachrichten ohne Code, die speziell für FIFO-Themen (First-In-First-Out) entwickelt wurde. Diese Funktion ermöglicht es den Eigentümern von Themen, Nachrichten bis zu 365 Tage lang direkt im Themenarchiv zu speichern und sie bei Bedarf für Abonnenten erneut abzuspielen. Die Archivierung und Wiedergabe von Nachrichten ist unerlässlich, um verloren gegangene Nachrichten wiederherzustellen und Anwendungen durch die Replikation von Status über Regionen oder Systeme hinweg zu synchronisieren.

Auf diese Funktionalität kann über die AWS API, das SDK und zugegriffen werden. CloudFormation AWS-Managementkonsole

**Wichtigste Anwendungsfälle**
+ **Nachrichtenwiederherstellung** — Stellen Sie Nachrichten wieder her, die aufgrund von Fehlern bei Downstream-Anwendungen verloren gegangen sind, indem Sie sie auf dem Endpunkt des Abonnenten abspielen.
+ **Statusreplikation** — Replizieren Sie den Status eines vorhandenen Systems in einer neuen Umgebung, indem Sie Nachrichten ab einem bestimmten Zeitstempel wiedergeben.
+ **Fehlerkorrektur** — Verpasste Nachrichten bei Ausfällen erneut senden, um sicherzustellen, dass alle Ereignisse korrekt verarbeitet werden.

### Komponenten der Nachrichtenarchivierung und -wiedergabe
<a name="message-archiving-and-replay-components"></a>

Verwalten Sie die Archivierung und Wiedergabe von Nachrichten für Amazon SNS FIFO-Themen, einschließlich der Festlegung von Aufbewahrungsfristen, der Überwachung archivierter Nachrichten mithilfe von CloudWatch, der Initiierung von Wiederholungen über Abonnementattribute und der Kenntnis der zum Ändern und Initiieren von Wiederholungen erforderlichen Berechtigungen.

**Archivierung von Nachrichten**
+ Der Eigentümer des Themas aktiviert die Archivierungsfunktion und legt den Aufbewahrungszeitraum für Nachrichten fest, der bis zu 365 Tage betragen kann. Weitere Informationen finden Sie unter [Amazon SNS SNS-Nachrichtenarchivierung für Inhaber von FIFO-Themen](message-archiving-and-replay-topic-owner.md)
+ CloudWatch Metriken helfen bei der Überwachung der archivierten Nachrichten.

**Wiedergabe von Nachrichten**
+ Ein Abonnent initiiert eine Wiederholung und wählt dabei das Zeitfenster aus, in dem die Nachrichten an den abonnierten Endpunkt erneut verarbeitet werden sollen. Weitere Informationen finden Sie unter [Wiederholung von Amazon SNS SNS-Nachrichten für Abonnenten zum Thema FIFO](message-archiving-and-replay-subscriber.md). 
+ Mithilfe der Funktion verwalten Sie die Wiedergabe mithilfe von Abonnementattributen. `ReplayPolicy`

**Relevante Berechtigungen**
+ **`SetSubscriptionAttributes`**— Erforderlich, um die Wiedergabeeinstellungen mithilfe des `ReplayPolicy` Attributs in einem Abonnement zu konfigurieren oder zu ändern.
+ **`Subscribe`**— Erforderlich, um ein neues Abonnement anzuhängen und Wiederholungen zu starten.
+ **`GetTopicAttributes`**— Ermöglicht das Anzeigen der Eigenschaften des Themas, aber bei der Initiierung von Wiederholungen geht es hauptsächlich um die Abonnementverwaltung.

# Amazon SNS SNS-Nachrichtenarchivierung für Inhaber von FIFO-Themen
<a name="message-archiving-and-replay-topic-owner"></a>

Mit der Nachrichtenarchivierung können Sie eine einzige Kopie aller zu Ihrem Thema veröffentlichten Nachrichten archivieren. Sie können veröffentlichte Nachrichten in Ihrem Thema speichern, indem Sie die Nachrichtenarchivierungsrichtlinie für das Thema aktivieren, wodurch die Nachrichtenarchivierung für alle Abonnements aktiviert wird, die mit diesem Thema verknüpft sind. Nachrichten können für mindestens einen Tag bis maximal 365 Tage archiviert werden.

Bei der Festlegung einer Archivrichtlinie fallen zusätzliche Gebühren an. Informationen zu den Preisen finden Sie unter [Amazon SNS – Preise](https://aws.amazon.com/sns/pricing/).

## Erstellen Sie eine Nachrichtenarchivierungsrichtlinie mit dem AWS-Managementkonsole
<a name="message-archiving-and-replay-topic-console"></a>

Verwenden Sie diese Option zum Erstellen einer neuen Nachrichtenarchivrichtlinie mit AWS-Managementkonsole.

1. Melden Sie sich bei der [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns/home) an.

1. Wählen Sie ein Thema aus oder erstellen Sie ein neues Thema. Weitere Informationen zum Erstellen von Themen finden Sie unter [Erstellen eines Amazon SNS-Themas](sns-create-topic.md).
**Anmerkung**  
Die Archivierung und Wiedergabe von Amazon SNS SNS-Nachrichten ist nur für application-to-application (A2A) FIFO-Themen verfügbar.

1. Erweitern Sie auf der Seite **Edit topic** (Thema bearbeiten) den Abschnitt **Archive policy** (Archivrichtlinie) .

1. Aktivieren Sie die Funktion **Archive policy** (Archivrichtlinie) und geben Sie im Thema die **Anzahl der Tage** ein, für die Sie Nachrichten archivieren möchten.

1. Wählen Sie **Änderungen speichern ** aus.

**Anzeigen, Bearbeiten und Deaktivieren einer Themenrichtlinie für die Nachrichtenarchivierung**
+ Auf der Seite **Topic details** (Themendetails) zeigt die **Retention policy** (Aufbewahrungsrichtlinie) den Status der Archivrichtlinie an, einschließlich der Anzahl der Tage, für die sie festgelegt ist. Wählen Sie die Registerkarte **Archive policy** (Archivrichtlinie), um die folgenden Details zum Nachrichtenarchiv anzuzeigen:
  + **Status** — Der Archivierungs- und Wiederholungsstatus wird als **active** (aktiv) angezeigt, wenn eine Archivrichtlinie angewendet wird. Der Archivierungs- und Wiederholungsstatus wird als **inactive** (inaktiv) angezeigt, wenn die Archivrichtlinie auf ein leeres JSON-Objekt festgelegt ist.
  + **Message retention period** (Aufbewahrungszeitraum für Nachrichten) – Die angegebene Anzahl von Tagen für die Aufbewahrung von Nachrichten.
  + **Archive start date** (Startdatum des Archivs) – Das Datum, ab dem Suscriber Nachrichten wiederholen können.
  + **JSON preview** (JSON-Vorschau) – Die JSON-Vorschau der Archivrichtlinie.
+ (Optional) Um eine Archivrichtlinie zu **bearbeiten**, wechseln Sie zur Seite mit der Themenzusammenfassung und wählen Sie **Edit** (Bearbeiten) aus.
+ (Optional) Um eine Archivrichtlinie zu **deaktivieren**, wechseln Sie zur Seite mit der Themenzusammenfassung und wählen Sie **Edit** (Bearbeiten) aus. Deaktivieren Sie die **Archive Policy** (Archivrichtlinie) und wählen Sie **Save changes** (Änderungen speichern).
+ (Optional) Um ein Thema mit einer Archivrichtlinie zu **löschen**, müssen Sie zuerst die Archivrichtlinie wie zuvor beschrieben deaktivieren.
**Wichtig**  
Um das versehentliche Löschen von Nachrichten zu vermeiden, ist es nicht möglich, ein Thema mit einer aktiven Nachrichtenarchivierungsrichtlinie zu löschen. Die Nachrichtenarchivierungsrichtlinie des Themas muss deaktiviert werden, bevor das Thema gelöscht werden kann. Wenn Sie eine Nachrichtenarchivierungsrichtlinie deaktivieren, löscht Amazon SNS alle archivierten Nachrichten. Beim Löschen eines Themas werden Abonnements entfernt und alle Nachrichten, die gerade übertragen werden, können möglicherweise nicht zugestellt werden.

## Eine Nachrichtenarchivierungsrichtlinie mit der API erstellen
<a name="message-archiving-and-replay-topic-api"></a>

Um mithilfe der API eine Nachrichtenarchivierungsrichtlinie zu erstellen, müssen Sie das Attribut `ArchivePolicy` zu Ihrem Thema hinzufügen. Sie können `ArchivePolicy` mithilfe der API-Aktionen `CreateTopic` und `SetTopicAttributes` festlegen. `ArchivePolicy` hat einen einzigen Wert, `MessageRetentionPeriod`, der die Anzahl der Tage darstellt, an denen Amazon SNS Nachrichten aufbewahrt. Um die Nachrichtenarchivierung für Ihr Thema zu aktivieren, legen Sie `MessageRetentionPeriod` auf einen ganzzahligen Wert größer als Null fest. Um beispielsweise Nachrichten 30 Tage lang in Ihrem Archiv aufzubewahren, legen Sie für `ArchivePolicy` Folgendes fest:

```
{
    "ArchivePolicy": {
        "MessageRetentionPeriod": "30"
    }
}
```

Um die Nachrichtenarchivierung für Ihr Thema zu deaktivieren und das Archiv zu löschen, deaktivieren Sie `ArchivePolicy` wie folgt:

```
{}
```

## Eine Nachrichtenarchivierungsrichtlinie mit dem SDK erstellen
<a name="message-archiving-and-replay-topic-sdk"></a>

Um ein AWS SDK zu verwenden, müssen Sie es mit Ihren Anmeldeinformationen konfigurieren. Weitere Informationen finden Sie unter [Geteilte `credentials` Dateien `config` und Dateien](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) im * AWS SDKs Referenzhandbuch zu Tools*.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie `ArchivePolicy` für ein Amazon SNS-Thema festlegen, damit alle Nachrichten, die zum Thema veröffentlicht wurden, 30 Tage lang aufbewahrt werden.

```
// Specify the ARN of the Amazon SNS topic to set the ArchivePolicy for.
String topicArn =
    "arn:aws:sns:us-east-2:123456789012:MyArchiveTopic.fifo";

// Set the MessageRetentionPeriod to 30 days for the ArchivePolicy.
String archivePolicy =
    "{\"MessageRetentionPeriod\":\"30\"}";

// Set the ArchivePolicy for the Amazon SNS topic
SetTopicAttributesRequest request = new SetTopicAttributesRequest()
    .withTopicArn(topicArn)
    .withAttributeName("ArchivePolicy")
    .withAttributeValue(archivePolicy);
sns.setTopicAttributes(request);
```

## Erstellen Sie eine Nachrichtenarchivierungsrichtlinie mit CloudFormation
<a name="message-archiving-and-replay-topic-cfn"></a>

Informationen zum Erstellen einer Archivrichtlinie CloudFormation finden Sie unter [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html)im *AWS CloudFormation Benutzerhandbuch*.

## Zugriff auf ein verschlüsseltes Archiv gewähren
<a name="message-archiving-and-replay-topic-kms"></a>

Bevor ein Suscriber mit der Wiederholung von Nachrichten aus einem verschlüsselten Thema beginnen kann, müssen Sie die folgenden Schritte ausführen. Da frühere Nachrichten wiederholt werden, muss Amazon SNS `Decrypt`-Zugriff auf den KMS-Schlüssel erhalten, der zur Verschlüsselung der Nachrichten im Archiv verwendet wurde.

1. Wenn Sie Nachrichten mit einem KMS-Schlüssel verschlüsseln und innerhalb des Themas speichern, müssen Sie Amazon SNS die Möglichkeit geben, diese Nachrichten über die Schlüsselrichtlinie zu entschlüsseln. Weitere Informationen finden Sie unter [Amazon SNS Entschlüsselungsberechtigungen gewähren](#message-archiving-and-replay-topic-decrypt-permissions).

1.  AWS KMS Für Amazon SNS aktivieren. Weitere Informationen finden Sie unter [Berechtigungen konfigurieren AWS KMS](sns-key-management.md#sns-what-permissions-for-sse).

**Wichtig**  
Ändern Sie beim Hinzufügen der neuen Abschnitte zur KMS-Schlüsselrichtlinie keinen der vorhandenen Abschnitte. Wenn die Verschlüsselung für ein Thema aktiviert ist und der KMS-Schlüssel deaktiviert oder gelöscht wird oder die KMS-Schlüsselrichtlinie nicht korrekt für Amazon SNS konfiguriert ist, kann Amazon SNS keine Nachrichten für Ihre Subscriber wiederholen. 

### Amazon SNS Entschlüsselungsberechtigungen gewähren
<a name="message-archiving-and-replay-topic-decrypt-permissions"></a>

Damit Amazon SNS auf verschlüsselte Nachrichten aus dem Archiv Ihres Themas zugreifen und sie auf abonnierten Endpunkten archivieren und wiederholen kann, müssen Sie das Amazon SNS-Serviceprinzip aktivieren, um diese Nachrichten zu entschlüsseln.

Im Folgenden finden Sie eine Beispielrichtlinie, die erforderlich ist, damit der Prinzipal des Amazon SNS gespeicherte Nachrichten während einer Wiederholung von historischen Nachrichten aus Ihrem Thema entschlüsseln kann.

```
{
    "Sid": "Allow SNS to decrypt archived messages",
    "Effect": "Allow",
    "Principal": {
        "Service": "sns.amazonaws.com"
    },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
    ],
    "Resource": "*"
}
```

## Überwachen Sie Messdaten zur Nachrichtenarchivierung mit Amazon CloudWatch
<a name="message-archiving-and-replay-topic-cloudwatch"></a>

Sie können archivierte Nachrichten mithilfe von Amazon CloudWatch anhand der folgenden Metriken überwachen. Um über Anomalien in Ihren Workloads informiert zu werden und Auswirkungen zu vermeiden, können Sie CloudWatch Amazon-Alarme für diese Metriken konfigurieren. Weitere Details finden Sie unter [Protokollierung und Überwachung in Amazon SNS](sns-logging-monitoring.md).


| Metrik | Description | 
| --- | --- | 
|  **ApproximateNumberOfMessagesArchived**  |  Stellt dem Eigentümer des Themas die Gesamtanzahl der im Themenarchiv archivierten Nachrichten mit einer Auflösung von 60 Minuten zur Verfügung.  | 
|  **ApproximateNumberOfBytesArchived**   |  Stellt dem Eigentümer des Themas die Gesamtanzahl der archivierten Bytes für alle Nachrichten im Themenarchiv mit einer Auflösung von 60 Minuten zur Verfügung.  | 
|  **NumberOfMessagesArchiveProcessing**   |  Nennt dem Eigentümer des Themas die Anzahl der Nachrichten, die während des Intervalls im Themenarchiv gespeichert wurden, mit einer Auflösung von 1 Minute.  | 
|  **NumberOfBytesArchiveProcessing**  |  Nennt dem Eigentümer des Themas die Gesamtzahl der Bytes, die während des Intervalls im Themenarchiv gespeichert wurden, mit einer Auflösung von 1 Minute.  | 

Die `GetTopicAttributes`-API verfügt über eine `BeginningArchiveTime`-Eigenschaft, die den ältesten Zeitstempel darstellt, zu dem ein Subscriber eine Wiederholung starten kann. Im Folgenden finden Sie eine Beispielantwort für diese API-Aktion:

```
{
 "ArchivePolicy": {
    "MessageRetentionPeriod": "<integer>"
  },
  "BeginningArchiveTime": "<timestamp>",
  ...
}
```

# Wiederholung von Amazon SNS SNS-Nachrichten für Abonnenten zum Thema FIFO
<a name="message-archiving-and-replay-subscriber"></a>

Amazon SNS Replay ermöglicht es Themenabonnenten, archivierte Nachrichten aus dem Themendatenspeicher abzurufen und erneut an einen abonnierten Endpunkt zu senden.
+ Nachrichten können sofort nach der Erstellung des Abonnements wiedergegeben werden.
+ Eine wiedergegebene Nachricht behält den gleichen Inhalt,`MessageId`, `Timestamp` wie das Original.
+ Die Nachricht enthält ein `Replayed` Attribut, das angibt, dass es sich um eine wiedergegebene Nachricht handelt.
+ Um nur bestimmte Nachrichten wiederzugeben, wenden Sie eine Filterrichtlinie auf Ihr Abonnement an.

Weitere Informationen zum Filtern von Nachrichten finden Sie unter [Filtert wiederholte Nachrichten](#message-archiving-and-replay-subscription-filtering).

## Erstellen Sie eine Richtlinie für die Nachrichtenwiedergabe mit dem AWS-Managementkonsole
<a name="message-archiving-and-replay-replaying-console"></a>

Verwenden Sie diese Option zum Erstellen einer neuen Wiederholungsrichtlinie mit AWS-Managementkonsole.

1. Melden Sie sich bei der [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns/home) an.

1. Wählen Sie ein Themenabonnement aus oder erstellen Sie ein neues Thema. Weitere Informationen zum Erstellen von Abonnements finden Sie unter [Ein Abonnement für ein Amazon SNS SNS-Thema erstellen](sns-create-subscribe-endpoint-to-topic.md).

1. Um die Nachrichtenwiederholung zu starten, rufen Sie das Dropdown-Menü **Replay** (Wiederholung) auf und wählen Sie **Start replay** (Wiederholung starten).

1. Treffen Sie im Modal **Replay timeframe** (Zeitrahmen für Wiederholung) die folgenden Auswahlen:

   1. **Startdatum und Uhrzeit der Wiedergabe wählen — Wählen Sie das Datum** **(YYYY/MM/DDFormat) und die **Uhrzeit**** (24-Stunden-Format hh:mm:ss) aus, ab dem Sie mit der Wiedergabe archivierter Nachrichten beginnen möchten. Die Startzeit muss nach Beginn der ungefähren Archivierungszeit liegen.

   1. **(Optional) Wählen Sie Datum und Uhrzeit für das Ende der Wiedergabe — Wählen Sie das Datum (YYYY/MM/DDFormat) und** **die **Uhrzeit**** (24-Stunden-Format hh:mm:ss) aus, zu der Sie die Wiedergabe archivierter Nachrichten beenden möchten.

   1. Wählen Sie **Start replay** „Wiederholung starten“.

1. (Optional) Um die Wiedergabe einer Nachricht zu **beenden**, rufen Sie die Seite mit den **Subscription details** (Abonnementdetails) auf und wählen Sie im Dropdown-Menü **Replay** (Wiederholung) die Option **Stop replay** (Wiederholung beenden) aus.

1. (Optional) Informationen zur **Überwachung** der Nachrichtenwiedergabe-Metriken innerhalb dieses Workflows mithilfe von finden Sie unter. CloudWatch [Überwachen Sie die Messdaten zur Nachrichtenwiedergabe mit Amazon CloudWatch](#message-archiving-and-replay-subscription-cloudwatch)

**Informationen zum Anzeigen und Bearbeiten einer Nachrichtenwiederholungsrichtlinie**

Auf der Seite **Subscription details** (Abonnementdetails) können Sie die folgenden Aktionen ausführen:
+ Um den Wiederholungsstatus der Nachricht **anzuzeigen**, werden im Feld **Replay status** (Wiederholungsstatus) die folgenden Werte angezeigt:
  + **Completed** (Abgeschlossen) – Die Wiederholung hat alle Nachrichten erfolgreich erneut zugestellt und stellt jetzt neu veröffentlichte Nachrichten zu.
  + **In progress** (In Bearbeitung) – Die Wiederholung wiederholt derzeit die ausgewählten Nachrichten.
  + **Failed** (Fehlgeschlagen) – Die Wiederholung konnte nicht abgeschlossen werden.
  + **Pending** (Ausstehend) – Der Standardstatus, während die Wiederholung gestartet wird.
+ **(Optional) Um eine Nachrichtenwiederholungsrichtlinie zu **ändern**, rufen Sie die Seite **Subscription details** (Abonnementdetails) auf und wählen Sie im Dropdown-Menü Replay** (Wiederholung) die Option **Start replay** (Wiederholung starten) aus. Durch das Starten einer Wiederholung wird die bestehende Wiederholung ersetzt.

## Dem Abonnement mithilfe der API eine Wiederholungsrichtlinie hinzufügen
<a name="message-archiving-and-replay-subscription-api"></a>

Verwenden Sie das Attribut `ReplayPolicy`, um archivierte Nachrichten zu wiederholen. `ReplayPolicy` kann mit den API-Aktionen `Subscribe` und `SetSubscriptionAttributes` verwendet werden. Diese Richtlinie hat folgende Werte:
+ **`StartingPoint`** (Obligatorisch) – Zeigt an, ab welchem Punkt die Wiederholung von Nachrichten gestartet werden soll.
+ **`EndingPoint`**(Optional) – Zeigt an, wann die Nachrichtenwiederholung beendet werden soll. Wenn `EndingPoint` weggelassen wird, wird die Wiederholung fortgesetzt, bis die aktuelle Uhrzeit erreicht ist.
+ **`PointType`** (Obligatorisch) – Legt den Typ der Start- und Endpunkte fest. Derzeit wird `Timestamp` als einziger Wert für `PointType` unterstützt.

Um beispielsweise nach dem Ausfall einer nachgeschalteten Anwendung eine Wiederherstellung durchzuführen und alle Nachrichten für einen Zeitraum von zwei Stunden am 1. Oktober 2023 erneut zu senden, verwenden Sie die API-Aktion `SetSubscriptionAttributes`, um wie folgt ein `ReplayPolicy` festzulegen:

```
{
  "PointType":"Timestamp", 
  "StartingPoint":"2023-10-01T10:00:00.000Z", 
  "EndingPoint":"2023-10-01T12:00:00.000Z"
}
```

Um alle Nachrichten, die am 1. Oktober 2023 an das Thema gesendet wurden, zu wiederholen und weiterhin alle neu veröffentlichten Nachrichten zu Ihrem Thema zu erhalten, verwenden Sie die API-Aktion `SetSubscriptionAttributes`, um wie folgt ein `ReplayPolicy` für Ihr Abonnement festzulegen:

```
{
  "PointType":"Timestamp",
  "StartingPoint":"2023-10-01T00:00:00.000Z"
}
```

Um zu überprüfen, ob eine Nachricht wiederholt wurde, wird jeder wiedergegebenen Nachricht das boolesche Attribut `Replayed` hinzugefügt.

## Dem Abonnement mithilfe des SDK eine Wiederholungsrichtlinie hinzufügen
<a name="message-replay-sdk"></a>

Um ein AWS SDK verwenden zu können, müssen Sie es mit Ihren Anmeldeinformationen konfigurieren. Weitere Informationen finden Sie unter [Geteilte `credentials` Dateien `config` und Dateien](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) im * AWS SDKs Referenzhandbuch zu Tools*.

Das folgende Codebeispiel zeigt, wie Sie `ReplayPolicy` bei einem Abonnement festlegen, damit Nachrichten aus dem Archiv des Amazon SNS FIFO-Themas für ein 2-stündiges Zeitfenster am 1. Oktober 2023 erneut zugestellt werden.

```
// Specify the ARN of the Amazon SNS subscription to initiate the ReplayPolicy on.
String subscriptionArn =
    "arn:aws:sns:us-east-2:123456789012:MyArchiveTopic.fifo:1d2a3e9d-7f2f-447c-88ae-03f1c68294da";

// Set the ReplayPolicy to replay messages from the topic's archive 
// for a 2 hour time period on October 1st 2023 between 10am and 12pm UTC.
String replayPolicy =
    "{\"PointType\":\"Timestamp\",\"StartingPoint\":\"2023-10-01T10:00:00.000Z\",\"EndingPoint\":\"2023-10-01T12:00:00.000Z\"}";

// Set the ArchivePolicy for the Amazon SNS topic
SetSubscriptionAttributesRequest request = new SetSubscriptionAttributesRequest()
    .withSubscriptionArn(subscriptionArn)
    .withAttributeName("ReplayPolicy")
    .withAttributeValue(replayPolicy);
sns.setSubscriptionAttributes(request);
```

## Verstehen der EndingPoint
<a name="message-archiving-and-replay-understanding-endpoint"></a>

Wenn Sie ein `ReplayPolicy` Abonnement für Amazon SNS beantragen, ist der `EndingPoint` Wert optional. Wenn kein `EndingPoint` Wert angegeben wird, beginnt die Wiedergabe an der angegebenen Uhrzeit `StartingPoint` und wird fortgesetzt, bis die aktuelle Uhrzeit erreicht ist, einschließlich der Verarbeitung neu veröffentlichter Nachrichten. Sobald das Abonnement abgeschlossen ist, funktioniert es wie ein reguläres Abonnement, bei dem neue Nachrichten empfangen werden, sobald sie veröffentlicht werden.

Wenn ein angegeben `EndingPoint` ist, spielt der Dienst Nachrichten von `StartingPoint` bis zu erneut ab `EndingPoint` und stoppt dann. **Durch diese Aktion wird das Abonnement effektiv angehalten.** Solange das Abonnement pausiert ist, werden neu veröffentlichte Nachrichten nicht an den abonnierten Endpunkt zugestellt.

Um die Nachrichtenzustellung wieder aufzunehmen, wenden Sie eine neue an, `ReplayPolicy` ohne eine anzugeben`EndingPoint`, und legen Sie `StartingPoint` den gewünschten Zeitpunkt fest, ab dem weiterhin Nachrichten empfangen werden sollen. Um beispielsweise ein Abonnement an der Stelle fortzusetzen, an der eine vorherige Wiedergabe beendet wurde, setzen Sie das neue Abonnement `StartingPoint` auf den zuvor bereitgestellten `EndingPoint` Wert.

## Filtert wiederholte Nachrichten
<a name="message-archiving-and-replay-subscription-filtering"></a>

Mit der Amazon SNS-Nachrichtenfilterung können Sie steuern, welche Nachrichten die Amazon SNS an Ihrem Abonnentenendpunkt wiederholt. Wenn sowohl Nachrichtenfilterung als auch Nachrichtenarchivierung aktiviert sind, ruft Amazon SNS die Nachricht zunächst aus dem Datenspeicher des Themas ab und ordnet sie dann dem `FilterPolicy` des Abonnements zu. Die Nachricht wird an den abonnierten Endpunkt übermittelt, wenn eine Übereinstimmung vorliegt, andernfalls wird die Nachricht herausgefiltert. Weitere Informationen finden Sie unter [Filterrichtlinien für Amazon-SNS-Abonnements](sns-subscription-filter-policies.md).

## Überwachen Sie die Messdaten zur Nachrichtenwiedergabe mit Amazon CloudWatch
<a name="message-archiving-and-replay-subscription-cloudwatch"></a>

Sie können Replay-Nachrichten mithilfe von Amazon CloudWatch anhand der folgenden Metriken überwachen. Um über Anomalien in Ihren Workloads informiert zu werden und Auswirkungen zu vermeiden, können Sie CloudWatch Amazon-Alarme für diese Metriken konfigurieren. Weitere Details finden Sie unter [Protokollierung und Überwachung in Amazon SNS](sns-logging-monitoring.md).


| Metrik | Description | 
| --- | --- | 
|  **NumberOfReplayedNotificationsDelivered**  |  Nennt dem Suscriber die Gesamtanzahl der aus dem Themenarchiv wiederholten Nachrichten mit einer Auflösung von 1 Minute.  | 
|  **NumberOfReplayedNotificationsFailed**   |  Nennt dem Suscriber die Gesamtanzahl der aus dem wiederholten Nachrichten mit einer Auflösung von 1 Minute, die nicht aus dem Themenarchiv zugestellt werden konnten.  | 