View a markdown version of this page

Benachrichtigungsoptionen mit AWS Backup - AWS Backup
Benutzerbenachrichtigungen und AWS BackupAmazon SNS und Ereignisse AWS Backup

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.

Benachrichtigungsoptionen mit AWS Backup

Es gibt zwei Möglichkeiten, Benachrichtigungen zu erhalten über AWS Backup:

  • Benutzerbenachrichtigungen kann Benachrichtigungen, einschließlich CloudWatch Amazon-Alarme AWS Support, und Benachrichtigungen anderer Dienste senden.

  • Amazon Simple Notification Service kann Sie über AWS Backup Ereignisse informieren.

Benutzerbenachrichtigungen und AWS Backup

AWS Backup unterstützt die Verwaltung Ihrer Backup-Benachrichtigungen von der Benutzerbenachrichtigungen Konsole aus. Mit Benutzerbenachrichtigungen können Sie den Fortschritt Ihrer Sicherungs-, Kopier- und Wiederherstellungsaufträge sowie Änderungen an Ihren Backup-Richtlinien, Tresoren, Wiederherstellungspunkten und Einstellungen von der Benutzerbenachrichtigungszentrale aus verfolgen.

Amazon CloudWatch, EventBridge Amazon-Alarme und AWS Support Fallaktualisierungen gehören zu anderen Arten von Benachrichtigungen, die Sie über die Konsole verwalten können. Darüber hinaus können Sie verschiedene Versandoptionen einrichten, darunter E-Mail, Amazon Q Developer in Chat-Anwendungen, Benachrichtigungen und AWS Console Mobile Application Push-Benachrichtigungen.

Amazon SNS und AWS Backup Veranstaltungen

AWS Backup nutzt die Vorteile der robusten Benachrichtigungen, die von Amazon Simple Notification Service (Amazon SNS) bereitgestellt werden. Sie können Amazon SNS so konfigurieren, dass Sie von der Amazon AWS Backup SNS-Konsole aus über Ereignisse informiert werden.

Einschränkungen

  • Der Amazon SNS-Service ermöglicht zwar kontoübergreifende Benachrichtigungen, unterstützt diese Funktion jedoch derzeit AWS Backup nicht. Sie müssen Ihre eigene AWS Konto-ID und den Ressourcen-ARN Ihres Themas angeben.

  • AWS Backup unterstützt Standardthemen für SNS-Deduplizierung nach besten Kräften, unterstützt aber derzeit AWS Backup keine SNS-FIFO-Themen für Strikte Deduplizierung.

Häufige Anwendungsfälle

Weitere allgemeine Informationen zu Amazon SNS finden Sie unter Erste Schritte mit Amazon SNS im Benutzerhandbuch für Amazon Simple Notification Service.

AWS Backup APIs für Benachrichtigungen

Nachdem Sie Ihre Themen mit der Amazon SNS-Konsole oder AWS Command Line Interface (AWS CLI) erstellt haben, können Sie die folgenden AWS Backup API-Operationen verwenden, um Ihre Backup-Benachrichtigungen zu verwalten.

AWS Backup unterstützt die folgenden Ereignisse:

Job type Veranstaltung
Backup-Auftrag BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | CONTINUOUS_BACKUP_INTERRUPTED
Kopierauftrag COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED
Wiederherstellungsauftrag RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED
Wiederherstellungspunkt RECOVERY_POINT_MODIFIED
Indexierung von Wiederherstellungspunkten RECOVERY_POINT_INDEX_COMPLETED | RECOVERY_POINT_INDEX_DELETED | RECOVERY_POINT_INDEXING_FAILED
Zugriffspunkt ACCESS_POINT_AVAILABLE | ACCESS_POINT_CREATION_FAILED | ACCESS_POINT_DELETED | ACCESS_POINT_DELETION_FAILED | ACCESS_POINT_EXPIRED | ACCESS_POINT_DISASSOCIATED

AWS Backup für S3 unterstützt zwei zusätzliche Ereignisse:

  • S3_BACKUP_OBJECT_FAILED benachrichtigt Sie über jedes S3-Objekt, das AWS Backup während eines Backup-Auftrags nicht sichern konnte.

  • S3_RESTORE_OBJECT_FAILED benachrichtigt Sie über jedes S3-Objekt, das AWS Backup während eines Wiederherstellungsauftrags nicht wiederherstellen konnte.

AWS Backup denn EKS unterstützt drei zusätzliche Ereignisse:

  • EKS_BACKUP_OBJECT_FAILEDbenachrichtigt Sie über alle EKS-Objekte, die während eines Sicherungsauftrags nicht gesichert AWS Backup werden konnten.

  • EKS_RESTORE_OBJECT_FAILEDbenachrichtigt Sie über alle EKS-Objekte, die während eines Wiederherstellungsauftrags AWS Backup nicht wiederhergestellt werden konnten.

  • EKS_RESTORE_OBJECT_SKIPPEDbenachrichtigt Sie über alle EKS-Objekte, die während eines AWS Backup Wiederherstellungsauftrags übersprungen wurden.

Beispiel für Ereignisse

Beispiel Beispiel: Der Sicherungsauftrag wurde abgeschlossen
{
    "Records": [{
        "EventSource": "aws:sns",
        "EventVersion": "1.0",
        "EventSubscriptionArn": "arn:aws:sns:...-a3802aa1ed45",
        "Sns": {
            "Type": "Notification",
            "MessageId": "12345678-abcd-123a-def0-abcd1a234567",
            "TopicArn": "arn:aws:sns:us-west-1:123456789012:backup-2sqs-sns-topic",
            "Subject": "Notification from AWS Backup",
            "Message": "An AWS Backup job was completed successfully. Recovery point ARN: arn:aws:ec2:us-west-1:123456789012:volume/vol-012f345df6789012d. Resource ARN : arn:aws:ec2:us-west-1:123456789012:volume/vol-012f345df6789012e. BackupJob ID : 1b2345b2-f22c-4dab-5eb6-bbc7890ed123",
            "Timestamp": "2019-08-02T18:46:02.788Z",
            ...
            "MessageAttributes": {
                "EventType": {"Type":"String","Value":"BACKUP_JOB"},
                "State": {"Type":"String","Value":"COMPLETED"},
                "AccountId": {"Type":"String","Value":"123456789012"},
                "Id": {"Type":"String","Value":"1b2345b2-f22c-4dab-5eb6-bbc7890ed123"},
                "StartTime": {"Type":"String","Value":"2019-09-02T13:48:52.226Z"}
            }
        }
    }]
}
Beispiel Beispiel: Der Sicherungsauftrag ist fehlgeschlagen
{
    "Records": [{
        "EventSource": "aws:sns",
        "EventVersion": "1.0",
        "EventSubscriptionArn": "arn:aws:sns:...-a3802aa1ed45",
        "Sns": {
            "Type": "Notification",
            "MessageId": "12345678-abcd-123a-def0-abcd1a234567",
            "TopicArn": "arn:aws:sns:us-west-1:123456789012:backup-2sqs-sns-topic",
            "Subject": "Notification from AWS Backup",
            "Message": "An AWS Backup job failed. Resource ARN : arn:aws:ec2:us-west-1:123456789012:volume/vol-012f345df6789012e. BackupJob ID : 1b2345b2-f22c-4dab-5eb6-bbc7890ed123",
            "Timestamp": "2019-08-02T18:46:02.788Z",
            ...
            "MessageAttributes": {
                "EventType": {"Type":"String","Value":"BACKUP_JOB"},
                "State": {"Type":"String","Value":"FAILED"},
                "AccountId": {"Type":"String","Value":"123456789012"},
                "Id": {"Type":"String","Value":"1b2345b2-f22c-4dab-5eb6-bbc7890ed123"},
                "StartTime": {"Type":"String","Value":"2019-09-02T13:48:52.226Z"}
            }
        }
    }]
}
Beispiel Beispiel: Der Sicherungsauftrag konnte während des Backup-Fensters nicht abgeschlossen werden
{
    "Records": [{
        "EventSource": "aws:sns",
        "EventVersion": "1.0",
        "EventSubscriptionArn": "arn:aws:sns:...-a3802aa1ed45",
        "Sns": {
            "Type": "Notification",
            "MessageId": "12345678-abcd-123a-def0-abcd1a234567",
            "TopicArn": "arn:aws:sns:us-west-1:123456789012:backup-2sqs-sns-topic",
            "Subject": "Notification from AWS Backup",
            "Message": "An AWS Backup job failed to complete in time. Resource ARN : arn:aws:ec2:us-west-1:123456789012:volume/vol-012f345df6789012e. BackupJob ID : 1b2345b2-f22c-4dab-5eb6-bbc7890ed123",
            "Timestamp": "2019-08-02T18:46:02.788Z",
            ...
            "MessageAttributes" : {
              "EventType" : {"Type":"String","Value":"BACKUP_JOB"},
              "State" : {"Type":"String","Value":"EXPIRED"},
              "AccountId" : {"Type":"String","Value":"123456789012"},
              "Id" : {"Type":"String","Value":"1b2345b2-f22c-4dab-5eb6-bbc7890ed123"},
              "StartTime" : {"Type":"String","Value":"2019-09-02T13:48:52.226Z"}
            }
        }
    }]
}
Beispiel Beispiel: Die Indexierung des Wiederherstellungspunkts wurde abgeschlossen
{
    "Records": [{
        "EventSource": "aws:sns",
        "EventVersion": "1.0",
        "EventSubscriptionArn": "arn:aws:sns:...-a3802aa1ed45",
        "Sns": {
            "Type": "Notification",
            "MessageId": "12345678-abcd-123a-def0-abcd1a234567",
            "TopicArn": "arn:aws:sns:us-west-1:123456789012:backup-2sqs-sns-topic",
            "Subject": "Notification from AWS Backup",
            "Message": "An AWS Backup backup index job was completed. Indexed recovery point arn: arn:aws:backup:us-west-2:1112233445566:recovery-point:abcd1234-5678-abcd-9012-abcdef123456",
            "Timestamp": "2025-05-25T18:46:02.788Z",
            ...
            "MessageAttributes" : {
              "EventType" : {"Type":"String","Value":"RECOVERY_POINT_INDEXING_COMPLETED"},
              "AccountId" : {"Type":"String","Value":"123456789012"},
              "IndexStatus" : {"Type":"String","Value":"ACTIVE"},
              "IsIndexingContinuous" : {"Type":"String","Value":"false"},
              "RecoveryPointArn" : {"Type":"String","Value":"arn:aws:backup:us-west-2:1112233445566:recovery-point:abcd1234-5678-abcd-9012-abcdef123456"}
            }
        }
    }]
}
Beispiel Beispiel: Das EKS-Backup-Objekt ist fehlgeschlagen
{
    "Records": [{
        "EventSource": "aws:sns",
        "EventVersion": "1.0",
        "EventSubscriptionArn": "arn:aws:sns:...-a3802aa1ed45",
        "Sns": {
            "Type": "Notification",
            "MessageId": "12345678-abcd-123a-def0-abcd1a234567",
            "TopicArn": "arn:aws:sns:us-west-1:123456789012:backup-2sqs-sns-topic",
            "Subject": "Notification from AWS Backup",
            "Message": "A Kubernetes resource failed to backup from your Amazon EKS Backup. Resource: example.resource.io/v1. EKS Cluster Name: eks-cluster-name. BackupJob ID: 1b2345b2-f22c-4dab-5eb6-bbc7890ed123",
            "Timestamp": "2025-05-25T18:46:02.788Z",
            ...
            "MessageAttributes" : {
              "eventType" : {"Type":"String","Value":"EKS_BACKUP_OBJECT_FAILED"},
              "backupJobId" : {"Type":"String","Value":"1b2345b2-f22c-4dab-5eb6-bbc7890ed123"},
              "clusterName" : {"Type":"String","Value":"eks-cluster-name"},
              "reason" : {"Type":"String","Value":"Example failure reason."},
              "resourceName" : {"Type":"String","Value":"example.resource.io/v1"}
            }
        }
    }]
}
Beispiel Beispiel: Das EKS-Wiederherstellungsobjekt ist fehlgeschlagen
{
    "Records": [{
        "EventSource": "aws:sns",
        "EventVersion": "1.0",
        "EventSubscriptionArn": "arn:aws:sns:...-a3802aa1ed45",
        "Sns": {
            "Type": "Notification",
            "MessageId": "12345678-abcd-123a-def0-abcd1a234567",
            "TopicArn": "arn:aws:sns:us-west-1:123456789012:backup-2sqs-sns-topic",
            "Subject": "Notification from AWS Backup",
            "Message": "A Kubernetes resource failed to restore from your Amazon EKS Backup. Resource: apiextensions.k8s.io/v1/customresourcedefinitions. Resource Name: exampleresource. Destination EKS Cluster Name: eks-restore-target-cluster-name. RestoreJob ID: 1b2345b2-f22c-4dab-5eb6-bbc7890ed123",
            "Timestamp": "2025-05-25T18:46:02.788Z",
            ...
            "MessageAttributes" : {
              "eventType" : {"Type":"String","Value":"EKS_RESTORE_OBJECT_FAILED"},
              "clusterName" : {"Type":"String","Value":"eks-restore-target-cluster-name"},
              "parentRestoreJobId" : {"Type":"String","Value":"12345678-abcd-123a-def0-abcd1a234567"},
              "reason" : {"Type":"String","Value":"Example failure reason."},
              "resourceName" : {"Type":"String","Value":"exampleresourceio"},
              "resourceType" : {"Type":"String","Value":"apiextensions.k8s.io/v1/customresourcedefinitions"},
              "restoreJobId" : {"Type":"String","Value":"1b2345b2-f22c-4dab-5eb6-bbc7890ed123"}
            }
        }
    }]
}
Beispiel Beispiel: Das EKS-Wiederherstellungsobjekt wurde übersprungen
{
    "Records": [{
        "EventSource": "aws:sns",
        "EventVersion": "1.0",
        "EventSubscriptionArn": "arn:aws:sns:...-a3802aa1ed45",
        "Sns": {
            "Type": "Notification",
            "MessageId": "12345678-abcd-123a-def0-abcd1a234567",
            "TopicArn": "arn:aws:sns:us-west-1:123456789012:backup-2sqs-sns-topic",
            "Subject": "Notification from AWS Backup",
            "Message": "A Kubernetes resource was skipped from restore from your Amazon EKS Backup. This Kubernetes resource already exists in your target EKS cluster. Resource: apiextensions.k8s.io/v1/customresourcedefinitions. Resource Name: exampleresource. Destination EKS Cluster Name: eks-restore-target-cluster-name. RestoreJob ID: 1b2345b2-f22c-4dab-5eb6-bbc7890ed123",
            "Timestamp": "2025-05-25T18:46:02.788Z",
            ...
            "MessageAttributes" : {
              "eventType" : {"Type":"String","Value":"EKS_RESTORE_OBJECT_SKIPPED"},
              "clusterName" : {"Type":"String","Value":"eks-restore-target-cluster-name"},
              "parentRestoreJobId" : {"Type":"String","Value":"12345678-abcd-123a-def0-abcd1a234567"},
              "reason" : {"Type":"String","Value":"Already exists."},
              "resourceName" : {"Type":"String","Value":"exampleresource"},
              "resourceType" : {"Type":"String","Value":"apiextensions.k8s.io/v1/customresourcedefinitions"},
              "restoreJobId" : {"Type":"String","Value":"1b2345b2-f22c-4dab-5eb6-bbc7890ed123"}
            }
        }
    }]
}
Beispiel Beispiel: Access Point verfügbar
{
    "Type": "Notification",
    "MessageId": "dd7579e6-47bb-51af-866c-1b36e07d9aaa",
    "TopicArn": "arn:aws:sns:us-east-1:123456789012:my-backup-topic",
    "Subject": "Notification from AWS Backup",
    "Message": "An AWS Backup access point was created successfully. Access point ARN: arn:aws:backup:us-east-1:123456789012:accesspoint/my-access-point. S3 access point ARN: arn:aws:s3:us-east-1:123456789012:accesspoint/my-access-point. Recovery point ARN: arn:aws:backup:us-east-1:123456789012:recovery-point:rp-1234567890abcdef0.",
    "Timestamp": "2026-07-28T12:00:26.426Z",
    "MessageAttributes": {
        "EventType": {"Type":"String","Value":"ACCESS_POINT_AVAILABLE"},
        "Status": {"Type":"String","Value":"AVAILABLE"},
        "AccountId": {"Type":"String","Value":"123456789012"},
        "AccessPointArn": {"Type":"String","Value":"arn:aws:backup:us-east-1:123456789012:accesspoint/my-access-point"},
        "CreationTime": {"Type":"String","Value":"2026-07-28T12:00:25.938846787Z"}
    }
}
Beispiel Beispiel: Die Erstellung des Access Points ist fehlgeschlagen
{
    "Type": "Notification",
    "MessageId": "abcdef01-2345-6789-abcd-ef0123456789",
    "TopicArn": "arn:aws:sns:us-east-1:123456789012:my-backup-topic",
    "Subject": "Notification from AWS Backup",
    "Message": "An AWS Backup access point failed to create. Access point ARN: arn:aws:backup:us-east-1:123456789012:accesspoint/my-access-point. Recovery point ARN: arn:aws:backup:us-east-1:123456789012:recovery-point:rp-1234567890abcdef0.",
    "Timestamp": "2026-07-28T12:05:10.123Z",
    "MessageAttributes": {
        "EventType": {"Type":"String","Value":"ACCESS_POINT_CREATION_FAILED"},
        "Status": {"Type":"String","Value":"FAILED"},
        "AccountId": {"Type":"String","Value":"123456789012"},
        "AccessPointArn": {"Type":"String","Value":"arn:aws:backup:us-east-1:123456789012:accesspoint/my-access-point"},
        "CreationTime": {"Type":"String","Value":"2026-07-28T12:04:55.123456789Z"}
    }
}
Beispiel Beispiel: Der Access Point ist abgelaufen
{
    "Type": "Notification",
    "MessageId": "fedcba98-7654-3210-fedc-ba9876543210",
    "TopicArn": "arn:aws:sns:us-east-1:123456789012:my-backup-topic",
    "Subject": "Notification from AWS Backup",
    "Message": "An AWS Backup access point expired. Access point ARN: arn:aws:backup:us-east-1:123456789012:accesspoint/my-access-point. Recovery point ARN: arn:aws:backup:us-east-1:123456789012:recovery-point:rp-1234567890abcdef0.",
    "Timestamp": "2026-07-28T18:30:05.789Z",
    "MessageAttributes": {
        "EventType": {"Type":"String","Value":"ACCESS_POINT_EXPIRED"},
        "Status": {"Type":"String","Value":"EXPIRED"},
        "AccountId": {"Type":"String","Value":"123456789012"},
        "AccessPointArn": {"Type":"String","Value":"arn:aws:backup:us-east-1:123456789012:accesspoint/my-access-point"},
        "CreationTime": {"Type":"String","Value":"2026-07-28T12:00:25.938846787Z"}
    }
}

AWS Backup Beispiele für Benachrichtigungsbefehle

Sie können AWS CLI Befehle verwenden, um Amazon SNS-Benachrichtigungen für Ihre AWS Backup Ereignisse zu abonnieren, aufzulisten und zu löschen.

Beispiel für eine Put-Benachrichtigung zum Backup-Tresor

Mit dem folgenden Befehl wird ein Amazon-SNS-Thema für den angegebenen Backup-Tresor abonniert, das Sie benachrichtigt, wenn ein Wiederherstellungsauftrag gestartet oder abgeschlossen oder wenn ein Wiederherstellungspunkt geändert wird.

aws backup put-backup-vault-notifications 
    --backup-vault-name myBackupVault 
    --sns-topic-arn arn:aws:sns:region:account-id:myBackupTopic
    --backup-vault-events RESTORE_JOB_STARTED RESTORE_JOB_COMPLETED RECOVERY_POINT_MODIFIED

Beispiel für eine Get-Benachrichtigung zum Backup-Tresor

Der folgende Befehl listet alle Ereignisse auf, die derzeit ein Amazon-SNS-Thema für den angegebenen Backup-Tresor abonniert haben.

aws backup get-backup-vault-notifications 
    --backup-vault-name myVault

Die Beispielausgabe lautet wie folgt:

{
    "SNSTopicArn": "arn:aws:sns:region:account-id:myBackupTopic",
    "BackupVaultEvents": [
        "RESTORE_JOB_STARTED",
        "RESTORE_JOB_COMPLETED",
        "RECOVERY_POINT_MODIFIED"
    ],
    "BackupVaultName": "myVault",
    "BackupVaultArn": "arn:aws:backup:region:account-id:backup-vault:myVault"
}

Beispiel für eine Löschbenachrichtigung zum Backup-Tresor

Mit dem folgenden Befehl wird das Abonnement eines Amazon-SNS-Themas für den angegebenen Backup-Tresor aufgehoben.

aws backup delete-backup-vault-notifications 
    --backup-vault-name myVault

Angeben AWS Backup als Service Principal

Anmerkung

Um SNS-Themen in Ihrem Namen veröffentlichen AWS Backup zu können, müssen Sie dies AWS Backup als Service Principal angeben.

Nehmen Sie den folgenden JSON-Code in die Zugriffsrichtlinie des Amazon SNS-Themas auf, das Sie zur Nachverfolgung AWS Backup von Ereignissen verwenden. Sie müssen den Amazon-Ressourcennamen (ARN) Ihres Themas angeben.

{
      "Sid": "My-statement-id",
      "Effect": "Allow",
      "Principal": {
        "Service": "backup.amazonaws.com"
      },
      "Action": "SNS:Publish",
      "Resource": "arn:aws:sns:region:account-id:myTopic"
}

Weitere Informationen zur Angabe eines Service-Principals in einer Amazon SNS-Zugriffsrichtlinie finden Sie unter Allowing Any AWS Resource to Publishing to a Topic im Amazon Simple Notification Service Developer Guide.

Anmerkung

Wenn Ihr Thema verschlüsselt ist, müssen Sie zusätzliche Berechtigungen in Ihre Richtlinie aufnehmen, AWS Backup damit es veröffentlicht werden kann. Weitere Informationen dazu, wie Services das Veröffentlichen von verschlüsselten Themen ermöglicht werden, finden Sie im Amazon Simple Notification Service Developer Guide unter Aktivieren der Kompatibilität zwischen Ereignisquellen aus AWS Diensten und verschlüsselten Themen.