Arbeiten mit Amazon-SNS-Ereignissen und Benachrichtigungen in AWS Database Migration Service - AWS Database Migration 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.

Arbeiten mit Amazon-SNS-Ereignissen und Benachrichtigungen in AWS Database Migration Service

Ab der Veröffentlichung von AWS DMS 3.4.5 und späteren Versionen empfehlen wir, Amazon EventBridge zu verwenden, um Benachrichtigungen bereitzustellen, wenn ein AWS DMS-Ereignis eintritt. Weitere Informationen zur Verwendung von EventBridge-Ereignissen mit AWS DMS finden Sie unter Arbeiten mit Amazon-Event-Bridge-Ereignissen und Benachrichtigungen in AWS Database Migration Service.

verschieben von Event-Abonnements zu Amazon EventBridge

Sie können den folgenden AWS CLI-Befehl verwenden, um bis zu 10 aktive Ereignis-Abonnements von DMS zu Amazon EventBridge zu migrieren.

update-subscriptions-to-event-bridge [--force-move | --no-force-move]

Standardmäßig migriert AWS DMS aktive Event-Abonnements nur, wenn Ihre Replikations-Instance die aktuelle Version AWS DMS 3.4.5 und höher hat. Zum Übergehen dieses Verhaltens kann die Option --force-move verwendet werden. Einige Ereignistypen sind jedoch möglicherweise nicht mit Amazon EventBridge verfügbar, wenn Ihre Replikations-Instances nicht aktualisiert wurden.

Um den update-subscriptions-to-event-bridge-CLI-Befehl ausführen zu können, muss ein AWS Identity and Access Management (IAM)-Benutzer über die folgenden Richtlinienberechtigungen verfügen.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "SNS:GetTopicAttributes", "SNS:SetTopicAttributes", "events:PutTargets", "events:EnableRule", "events:PutRule" ], "Resource": "*" } ] }

Weitere Informationen zum Verschieben von Abonnements zu EventBridge finden Sie unter UpdateSubscriptionsToEventBridge in der AWS Database Migration Service-API-Referenz.

Arbeiten mit Amazon-SNS-Ereignissen und Benachrichtigungen

Die AWS DMS-Versionen 3.4.5 und früher unterstützen die Arbeit mit Ereignissen und Benachrichtigungen, wie im Folgenden beschrieben.

AWS Database Migration Service (AWS DMS) kann Amazon Simple Notification Service (Amazon SNS) verwenden, um Benachrichtigungen bereitzustellen, wenn ein AWS-DMS-Ereignis eintritt, z. B. die Erstellung oder Löschung einer Replikations-Instance. Sie können mit diesen Benachrichtigungen in einem beliebigen Format arbeiten, das von Amazon SNS für eine AWS-Region unterstützt wird, z. B. als E-Mail-Nachricht, Textnachricht oder Aufruf an einen HTTP-Endpunkt.

AWS DMS stuft Ereignisse in Kategorien ein, die Sie abonnieren können. Dadurch werden Sie benachrichtigt, wenn ein Ereignis in dieser Kategorie auftritt. Wenn Sie beispielsweise die Kategorie "Erstellung" für eine bestimmte Replikations-Instance abonnieren, werden Sie benachrichtigt, sobald ein erstellungsbezogenes Ereignis auftritt, das sich auf Ihre Replikations-Instance auswirkt. Wenn Sie eine Konfigurationsänderungs-Kategorie für eine Replikations-Instance abonnieren, werden Sie benachrichtigt, wenn die Konfiguration der Replikations-Instance geändert wird. Außerdem erhalten Sie eine Benachrichtigung, wenn ein Abonnement für Ereignisbenachrichtigungen geändert wird. Eine Liste der von AWS DMS bereitgestellten Ereigniskategorien finden Sie im Folgenden unter AWS-DMS-Ereigniskategorien und -Ereignismeldungen für SNS-Benachrichtigungen.

AWS DMS sendet Ereignisbenachrichtigungen an die Adressen, die Sie beim Erstellen eines Ereignisabonnements angeben. Sie sollten mehrere verschiedene Abonnements erstellen, beispielsweise ein Abonnement, das alle Ereignisbenachrichtigungen empfängt, und ein anderes Abonnement, das nur kritische Ereignisse für Ihre DMS-Produktionsressourcen enthält. Sie können Benachrichtigungen einfach ohne Löschen eines Abonnements deaktivieren, indem Sie die Option Aktiviert in der AWS-Konsole abwählen, oder indem Sie für den Parameter Enabled mithilfe der AWS-API den Wert auf false festlegen.

Anmerkung

AWS-DMS-Ereignisbenachrichtigungen mithilfe von SMS-Nachrichten sind derzeit für AWS-Ressourcen in allen AWS-Regionen verfügbar, in denen Amazon SNS unterstützt wird. Eine Liste der AWS-Regionen und Länder, in denen Amazon SNS SMS-Nachrichten unterstützt, finden Sie unter Unterstützte Regionen und Länder.

Weitere Informationen zum Verwenden von SMS-Nachrichten mit SNS finden Sie unter Sending and receiving SMS notifications using Amazon SNS (Senden und Empfangen von SMS-Benachrichtigungen mit Amazon SNS).

AWS DMS-Ereignisbenachrichtigungen unterscheiden sich von CloudTrail-Ereignissen in CloudWatch oder EventBridge. CloudTrail-Ereignisbenachrichtigungen können durch jeden API-Aufruf generiert werden. DMS sendet nur dann eine Benachrichtigung, wenn ein DMS-Ereignis eintritt.

AWS DMS verwendet eine Abonnement-ID zum Identifizieren des jeweiligen Abonnements. Sie können mehrere AWS-DMS-Ereignisabonnements in demselben Amazon-SNS-Thema veröffentlichen. Wenn Sie Ereignisbenachrichtigungen nutzen, fallen Amazon-SNS-Gebühren an. Weitere Informationen zur Fakturierung von Amazon SNS finden Sie unter Amazon SNS – Preise.

Gehen Sie zum Abonnieren von AWS-DMS-Ereignissen wie folgt vor:

  1. Erstellen Sie ein Amazon-SNS-Thema. Im Thema geben Sie an, welche Art von Benachrichtigung Sie empfangen möchten und an welche Adresse oder Nummer die Benachrichtigung gesendet werden soll.

  2. Erstellen Sie mit der AWS Management Console-, der AWS CLI- oder der AWS-DMS-API ein Abonnement für AWS-DMS-Ereignisbenachrichtigungen.

  3. AWS DMS sendet eine Bestätigungs-E-Mail oder SMS-Nachricht an die Adressen, die Sie mit Ihrem Abonnement übermittelt haben. Um Ihr Abonnement zu bestätigen, klicken Sie in der Bestätigungs-E-Mail oder SMS-Nachricht auf den Link.

  4. Wenn Sie das Abonnement bestätigt haben, wird der Status Ihres Abonnements im Abschnitt Ereignisabonnements in der AWS-DMS-Konsole aktualisiert.

  5. Sie erhalten dann Ereignisbenachrichtigungen.

Die Liste der Kategorien und Ereignisse, über die Sie benachrichtigt werden können, finden Sie im folgenden Abschnitt. Weitere Informationen zum Abonnieren von und Arbeiten mit AWS-DMS-Ereignisabonnements finden Sie unter Abonnieren von AWS-DMS-Ereignisbenachrichtigungen mithilfe von SNS.

Themen

    AWS-DMS-Ereigniskategorien und -Ereignismeldungen für SNS-Benachrichtigungen

    Wichtig

    Ab der Veröffentlichung von AWS DMS 3.4.5 und späteren Versionen empfehlen wir, Amazon EventBridge zu verwenden, um Benachrichtigungen bereitzustellen, wenn ein AWS DMS-Ereignis eintritt. Weitere Informationen zur Verwendung von EventBridge-Ereignissen mit AWS DMS finden Sie unter Arbeiten mit Amazon-Event-Bridge-Ereignissen und Benachrichtigungen in AWS Database Migration Service.

    AWS DMS generiert eine beträchtliche Anzahl von Ereignissen in Kategorien, die Sie mithilfe der AWS-DMS -Konsole oder der AWS-DMS-API abonnieren können. Jede Kategorie gilt für einen Quelltyp. Derzeit unterstützt AWS DMS die Quelltypen „Replikations-Instance“ und „Replikationsaufgabe“.

    In der folgenden Tabelle sind die möglichen Kategorien und Ereignisse für den Quelltyp "Replikations-Instance" angegeben.

    Kategorie

    DMS-Ereignis-ID

    Beschreibung

    Konfigurationsänderung DMS-EVENT-0012

    Die Replikations-Instance-Klasse für diese Replikations-Instance wird geändert.

    Konfigurationsänderung DMS-EVENT-0014

    Die Replikations-Instance-Klasse für diese Replikations-Instance wurde geändert.

    Konfigurationsänderung DMS-EVENT-0018

    Der Speicher für die Replikations-Instance wird erweitert.

    Konfigurationsänderung DMS-EVENT-0017

    Der Speicher für die Replikations-Instance wurde erweitert.

    Konfigurationsänderung DMS-EVENT-0024

    Die Replikations-Instance wird auf eine Multi-AZ-Konfiguration umgestellt.

    Konfigurationsänderung DMS-EVENT-0025

    Die Umstellung der Replikations-Instance auf eine Multi-AZ-Konfiguration ist abgeschlossen.

    Konfigurationsänderung DMS-EVENT-0030

    Die Replikations-Instance wird auf eine Single-AZ-Konfiguration umgestellt.

    Konfigurationsänderung DMS-EVENT-0029

    Die Umstellung der Replikations-Instance auf eine Single-AZ-Konfiguration ist abgeschlossen.

    Erstellung DMS-EVENT-0067

    Eine Replikations-Instance wird erstellt.

    Erstellung DMS-EVENT-0005

    Eine Replikations-Instance wird erstellt.

    Löschung DMS-EVENT-0066

    Die Replikations-Instance wird gelöscht.

    Löschung DMS-EVENT-0003

    Die Replikations-Instance wird gelöscht.

    Wartung DMS-EVENT-0047 Die Managementsoftware auf der Replikations-Instance wurde aktualisiert.
    Wartung DMS-EVENT-0026 Die Offline-Wartung der Replikations-Instance wird durchgeführt. Die Replikations-Instance steht derzeit nicht zur Verfügung.
    Wartung DMS-EVENT-0027 Die Offline-Wartung der Replikations-Instance ist abgeschlossen. Die Replikations-Instance steht nun zur Verfügung.
    Wartung DMS-EVENT-0068 Eine Replikations-Instance befindet sich in einem Zustand, der nicht aktualisiert werden kann.
    LowStorage DMS-EVENT-0007 Die Replikations-Instance hat mehr als 90 % ihres zugewiesenen Speichers verbraucht. Sie können den Speicherplatz für eine Replikations-Instance mit der Metrik „Freier Speicherplatz“ überwachen.
    Failover DMS-EVENT-0013 Failover für eine Multi-AZ-Replikations-Instance wurde gestartet.
    Failover DMS-EVENT-0049 Failover für eine Multi-AZ-Replikations-Instance ist abgeschlossen.
    Failover DMS-EVENT-0015 Multi-AZ-Failover zu Standby ist abgeschlossen.
    Failover DMS-EVENT-0050 Die Multi-AZ-Aktivierung wurde gestartet.
    Failover DMS-EVENT-0051 Die Multi-AZ-Aktivierung wurde abgeschlossen.
    Failover DMS-EVENT-0034 Wenn Sie zu häufig einen Failover anfordern, wird dieses Ereignis anstelle regelmäßiger Failover-Ereignisse ausgelöst.
    Fehler DMS-EVENT-0031 Bei der Replikations-Instance ist ein Speicherfehler aufgetreten.
    Fehler DMS-EVENT-0036 Die Replikations-Instance ist aufgrund eines nicht kompatiblen Netzwerks fehlgeschlagen.
    Fehler DMS-EVENT-0037 Der Service kann nicht auf den AWS KMS-Schlüssel zugreifen, der zur Verschlüsselung des Daten-Volumes verwendet wurde.

    In der folgenden Tabelle sind die möglichen Kategorien und Ereignisse für den Quelltyp „Replikationsaufgabe“ angegeben.

    Kategorie

    DMS-Ereignis-ID

    Beschreibung

    Statusänderung DMS-EVENT-0069

    Die Replikationsaufgabe wurde gestartet.

    Statusänderung DMS-EVENT-0081

    Das Neuladen der Tabellendetails wurde angefordert.

    Statusänderung DMS-EVENT-0079

    Die Replikationsaufgabe wurde angehalten.

    Statusänderung DMS-EVENT-0091 Der Lesevorgang wurde unterbrochen, das Limit für die Auslagerungsdateien wurde erreicht.
    Statusänderung DMS-EVENT-0092 Der Lesevorgang wurde unterbrochen, das Limit für die Festplattennutzung wurde erreicht.
    Statusänderung DMS-EVENT-0093 Der Lesevorgang wurde fortgesetzt.
    Fehler DMS-EVENT-0078

    Die Replikationsaufgabe ist fehlgeschlagen.

    Fehler DMS-EVENT-0082

    Ein Aufruf zum Löschen der Aufgabe konnte die Aufgabendaten nicht bereinigen.

    Konfigurationsänderung DMS-EVENT-0080 Die Replikationsaufgabe wird geändert.
    Löschung DMS-EVENT-0073

    Die Replikationsaufgabe wird gelöscht.

    Erstellung DMS-EVENT-0074 Die Replikationsaufgabe wird erstellt.

    Das folgende Beispiel zeigt ein AWS DMS-Ereignisabonnement mit der Kategorie „Statusänderung“.

    Resources: DMSEvent: Type: AWS::DMS::EventSubscription Properties: Enabled: true EventCategories: State Change SnsTopicArn: arn:aws:sns:us-east-1:123456789:testSNS SourceIds: [] SourceType: replication-task

    Abonnieren von AWS-DMS-Ereignisbenachrichtigungen mithilfe von SNS

    Wichtig

    Ab der Veröffentlichung von AWS DMS 3.4.5 und späteren Versionen empfehlen wir, Amazon EventBridge zu verwenden, um Benachrichtigungen bereitzustellen, wenn ein AWS DMS-Ereignis eintritt. Weitere Informationen zur Verwendung von EventBridge-Ereignissen mit AWS DMS finden Sie unter Arbeiten mit Amazon-Event-Bridge-Ereignissen und Benachrichtigungen in AWS Database Migration Service.

    Sie können ein Abonnement für AWS DMS-Ereignisbenachrichtigungen erstellen, sodass Sie beim Auftreten eines AWS DMS-Ereignisses benachrichtigt werden. Am einfachsten lässt sich ein Abonnement mit der AWS DMS-Konsole erstellen. In einem Benachrichtigungsabonnement entscheiden Sie, wie und wohin Benachrichtigungen gesendet werden sollen. Sie geben den Quelltyp an, zu dem Sie Benachrichtigungen erhalten möchten. Derzeit werden die Quelltypen „Replikations-Instance“ und „Replikationsaufgabe“ von AWS DMS unterstützt. Je nach ausgewähltem Quelltyp wählen Sie die Ereigniskategorien und identifizieren die Quellen, für die Sie Ereignisbenachrichtigungen erhalten möchten.

    Verwendung von AWS Management Console

    Wichtig

    Ab der Veröffentlichung von AWS DMS 3.4.5 und späteren Versionen empfehlen wir, Amazon EventBridge zu verwenden, um Benachrichtigungen bereitzustellen, wenn ein AWS DMS-Ereignis eintritt. Weitere Informationen zur Verwendung von EventBridge-Ereignissen mit AWS DMS finden Sie unter Arbeiten mit Amazon-Event-Bridge-Ereignissen und Benachrichtigungen in AWS Database Migration Service.

    So abonnieren Sie AWS-DMS-Ereignisbenachrichtigungen mit Amazon SNS mithilfe der Konsole
    1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die AWS DMS-Konsole unter https://console.aws.amazon.com/dms/v2/.

      Wenn Sie als IAM-Benutzer angemeldet sind, müssen Sie über die entsprechenden Berechtigungen für den Zugriff auf AWS DMS verfügen.

    2. Wählen Sie im Navigationsbereich Ereignisabonnements aus.

    3. Wählen Sie auf der Seite Ereignisabonnements die Option Ereignisabonnement erstellen aus.

    4. Gehen Sie auf der Seite Ereignisabonnement erstellen wie folgt vor:

      1. Geben Sie unter Details für Name einen Namen für das Abonnement für Ereignisbenachrichtigungen ein.

      2. Wählen Sie Aktiviert, um das Abonnement zu aktivieren. Wenn Sie das Abonnement erstellen möchten, jedoch noch keine Benachrichtigungen gesendet haben, wählen Sie nicht Aktiviert aus.

      3. Wählen Sie unter Ziel entweder Vorhandene Themen, Neues E-Mail-Thema erstellen oder Neues SMS-Thema erstellen aus, um Benachrichtigungen zu senden. Entweder müssen Sie ein vorhandenes Amazon-SNS-Thema haben, an das Sie Benachrichtigungen senden möchten, oder Sie müssen das Thema selbst erstellen. Wenn Sie ein Thema erstellen, können Sie eine E-Mail-Adresse eingeben, an die die Benachrichtigungen gesendet werden sollen.

      4. Wählen Sie unter Ereignisquelle für Quelltyp einen Quelltyp aus. Die einzigen Optionen sind replication-instance und replication-task.

      5. Je nach ausgewähltem Quelltyp wählen Sie die Ereigniskategorien und Quellen aus, für die Sie Ereignisbenachrichtigungen erhalten möchten.

        Erstellen eines Ereignis-Abonnements mit der Konsole
      6. Wählen Sie Ereignis-Abonnement erstellen.

    In der AWS-DMS-Konsole wird die Erstellung des Abonnements angezeigt.

    Anmerkung

    Sie können auch mithilfe der AWS DMS-API und der CLI Abonnements für Amazon-SNS-Ereignisbenachrichtigungen erstellen. Weitere Informationen finden Sie unter CreateEventSubscription in der AWS DMSAPI-Referenz und create-event-subscription in der AWS DMS.CLI-Referenzdokumentation.

    Überprüfen der Zugriffsrichtlinie für Ihr SNS-Thema

    Ihre SNS-Zugriffsrichtlinie erfordert Berechtigungen, die es AWS DMS ermöglichen, Ereignisse zu Ihrem SNS-Thema zu veröffentlichen. Sie können Ihre Zugriffsrichtlinie wie in den folgenden Verfahren beschrieben validieren und aktualisieren.

    So validieren Sie Ihre Zugriffsrichtlinie
    1. Öffnen Sie die Amazon-SNS-Konsole.

    2. Wählen Sie im Navigationsbereich Themen und dann das Thema aus, zu dem Sie DMS-Benachrichtigungen erhalten möchten.

    3. Wählen Sie die Registerkarte Zugriffsrichtlinie aus.

    Sie können Ihre Richtlinie aktualisieren, wenn Ihre SNS-Zugriffsrichtlinie die Veröffentlichung von Ereignissen zu Ihrem SNS-Thema durch AWS DMS nicht zulässt.

    So aktualisieren Sie Ihre Zugriffsrichtlinie
    1. Wählen Sie auf Ihrer Themenseite im Bereich Details die Option Bearbeiten aus.

    2. Erweitern Sie den Abschnitt Zugriffsrichtlinie und fügen Sie das folgende Richtliniendokument in den JSON-Editor ein.

      { "Sid": "dms-allow-publish", "Effect": "Allow", "Principal": { "Service": "dms.amazonaws.com" }, "Action": "sns:Publish", "Resource": "your-SNS-topic-ARN" }

      Wir empfehlen Ihnen, den Zugriff auf Ihr SNS-Thema weiter einzuschränken, indem Sie die aws:SourceArn-Bedingung angeben, d. h. den DMS-EventSubscription-ARN, der Ereignisse zum Thema veröffentlicht.

      ... "Resource": "your-SNS-topic-ARN" "Condition": { "StringEquals": { "aws:SourceArn": "arn:partition:dms:your-AWS-region:your-AWS-account-ID:es:your-dms-es-arn or *" }
    3. Wählen Sie Save Changes.