Notifications des utilisateurs et AWS Backup Amazon SNS et événements AWS Backup

Options de notification avec AWS Backup

Il existe deux manières de recevoir des notifications concernant AWS Backup :

Notifications des utilisateurs peut envoyer des notifications, y compris CloudWatch des alarmes Amazon AWS Support, et des notifications d'autres services.
Amazon Simple Notification Service peut vous informer des AWS Backup événements.

Notifications des utilisateurs and AWS Backup

AWS Backup prend en charge la gestion de vos notifications de sauvegarde depuis la Notifications des utilisateurs console. Avec Notifications des utilisateurs, vous pouvez consulter la progression de vos tâches de sauvegarde, de copie et de restauration ainsi que les modifications apportées à vos politiques de sauvegarde, à vos coffres-forts, à vos points de restauration et à vos paramètres depuis le centre de notifications utilisateur.

Amazon CloudWatch, EventBridge les alarmes Amazon et AWS Support les mises à jour des dossiers font partie des autres types de notifications que vous pouvez gérer depuis la console. En outre, vous pouvez configurer plusieurs options de diffusion, notamment le courrier électronique, les notifications Amazon Q Developer dans les applications de chat et les notifications AWS Console Mobile Application push.

Amazon SNS et AWS Backup events

AWS Backup tire parti des notifications robustes délivrées par Amazon Simple Notification Service (Amazon SNS). Vous pouvez configurer Amazon SNS pour qu'il vous informe des AWS Backup événements depuis la console Amazon SNS.

Limitations

Bien que le service Amazon SNS autorise les notifications entre comptes, il AWS Backup ne prend pas en charge cette fonctionnalité pour le moment. Vous devez spécifier votre propre identifiant de AWS compte et l'ARN de ressource de votre rubrique.
AWS Backup prend en charge les rubriques standard pour la déduplication optimale du SNS, mais AWS Backup ne prend pas en charge actuellement les rubriques FIFO SNS pour la déduplication stricte.

Configurez des notifications pour les tâches de sauvegarde ayant échoué en suivant les étapes décrites dans Comment puis-je recevoir des notifications pour les AWS Backup tâches ayant échoué ? depuis AWS Premium Support.
Consultez des exemples de notifications JSON Amazon SNS pour les tâches de sauvegarde terminées, échouées ou expirées dans le tableau des exemples d'événements ci-dessous.

Pour plus d'informations sur Amazon SNS de façon générale, consultez Démarrage avec Amazon SNS dans le Guide du développeur Amazon Simple Notification Service.

Après avoir créé vos sujets à l'aide de la console Amazon SNS ou AWS Command Line Interface (AWS CLI), vous pouvez utiliser les opérations d' AWS Backup API suivantes pour gérer vos notifications de sauvegarde.

DeleteBackupVaultNotifications : supprime les notifications d'événement SNS pour le coffre-fort de sauvegarde spécifié.
GetBackupVaultNotifications : répertorie toutes les notifications d'événement SNS pour le coffre-fort de sauvegarde spécifié.
PutBackupVaultNotifications : active les notifications pour la rubrique et les événements spécifiés.

AWS Backup soutient les événements suivants :

Type de tâche	Événement
Tâche de sauvegarde	`BACKUP_JOB_STARTED` \| `BACKUP_JOB_COMPLETED` \| `BACKUP_JOB_SUCCESSFUL` \| `BACKUP_JOB_FAILED` \| `BACKUP_JOB_EXPIRED` \| `CONTINUOUS_BACKUP_INTERRUPTED`
Tâche de copie	`COPY_JOB_STARTED` \| `COPY_JOB_SUCCESSFUL` \| `COPY_JOB_FAILED`
Tâche de restauration	`RESTORE_JOB_STARTED` \| `RESTORE_JOB_COMPLETED` \| `RESTORE_JOB_SUCCESSFUL` \| `RESTORE_JOB_FAILED`
Point de récupération	`RECOVERY_POINT_MODIFIED`
Indexation des points de restauration	`RECOVERY_POINT_INDEX_COMPLETED` \| `RECOVERY_POINT_INDEX_DELETED` \| `RECOVERY_POINT_INDEXING_FAILED`
Point d'accès	`ACCESS_POINT_AVAILABLE` \| `ACCESS_POINT_CREATION_FAILED` \| `ACCESS_POINT_DELETED` \| `ACCESS_POINT_DELETION_FAILED` \| `ACCESS_POINT_EXPIRED` \| `ACCESS_POINT_DISASSOCIATED`

AWS Backup pour S3 prend en charge deux événements supplémentaires :

S3_BACKUP_OBJECT_FAILED vous informe de tout échec de la sauvegarde d'un objet S3 lors d'une tâche de sauvegarde avec AWS Backup .
S3_RESTORE_OBJECT_FAILED vous informe de tout échec de la restauration d'un objet S3 lors d'une tâche de restauration avec AWS Backup .

AWS Backup for EKS soutient trois événements supplémentaires :

EKS_BACKUP_OBJECT_FAILEDvous informe de tout objet EKS qui AWS Backup n'a pas pu être sauvegardé au cours d'une tâche de sauvegarde.
EKS_RESTORE_OBJECT_FAILEDvous informe de tout objet EKS qui AWS Backup n'a pas pu être restauré au cours d'une tâche de restauration.
EKS_RESTORE_OBJECT_SKIPPEDvous informe de tous les objets EKS qui ont été AWS Backup ignorés pendant une tâche de restauration.

Exemple Exemple : tâche de sauvegarde terminée


{
    "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"}
            }
        }
    }]
}

Exemple Exemple : échec de la tâche de sauvegarde


{
    "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"}
            }
        }
    }]
}

Exemple Exemple : la tâche de sauvegarde n'a pas pu être terminée pendant la fenêtre de sauvegarde


{
    "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"}
            }
        }
    }]
}

Exemple Exemple : indexation des points de récupération terminée


{
    "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"}
            }
        }
    }]
}

Exemple Exemple : échec de l'objet de sauvegarde EKS


{
    "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"}
            }
        }
    }]
}

Exemple Exemple : échec de l'objet de restauration EKS


{
    "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"}
            }
        }
    }]
}

Exemple Exemple : objet de restauration EKS ignoré


{
    "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"}
            }
        }
    }]
}

Exemple Exemple : point d'accès disponible


{
    "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"}
    }
}

Exemple Exemple : échec de la création du point d'accès


{
    "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"}
    }
}

Exemple Exemple : le point d'accès a expiré


{
    "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"}
    }
}

Vous pouvez utiliser AWS CLI des commandes pour vous abonner aux notifications Amazon SNS relatives à vos AWS Backup événements, les répertorier et les supprimer.

Exemple de notification de mise en place d'un coffre-fort de sauvegarde

La commande suivante s'abonne à une rubrique Amazon SNS pour le coffre-fort de sauvegarde spécifié qui vous avertit lorsqu'une tâche de restauration est lancée ou terminée, ou lorsqu'un point de récupération est modifié.


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

Exemple de notification d'obtention d'un coffre-fort de sauvegarde

La commande suivante répertorie tous les événements actuellement abonnés à une rubrique Amazon SNS pour le coffre-fort de sauvegarde spécifié.


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

L'exemple de sortie se présente comme suit :


{
    "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"
}

Exemple de notification de suppression d'un coffre-fort de sauvegarde

La commande suivante se désabonne d'une rubrique Amazon SNS pour le coffre-fort de sauvegarde spécifié.


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

Spécifier AWS Backup en tant que directeur de service

Note

AWS Backup Pour autoriser la publication de sujets SNS en votre nom, vous devez spécifier AWS Backup en tant que responsable du service.

Incluez le code JSON suivant dans la politique d'accès de la rubrique Amazon SNS que vous utilisez pour suivre les AWS Backup événements. Vous devez spécifier l'Amazon Resource Name (ARN) de la ressource de votre rubrique.


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

Pour plus d'informations sur la spécification d'un principal de service dans une politique d'accès Amazon SNS, consultez la section Autoriser la publication de n'importe quelle AWS ressource dans un sujet dans le manuel Amazon Simple Notification Service Developer Guide.

Note

Si votre sujet est chiffré, vous devez inclure des autorisations supplémentaires dans votre politique AWS Backup pour permettre d'y publier. Pour plus d'informations sur la possibilité pour les services de publier sur des sujets chiffrés, voir Activer la compatibilité entre les sources d'événements provenant AWS des services et les sujets chiffrés dans le guide du développeur Amazon Simple Notification Service.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Logging AWS Backup Appels d'API avec CloudTrail

Résolution des problèmes AWS Backup

Options de notification avec AWS Backup

Notifications des utilisateurs and AWS Backup

Amazon SNS et AWS Backup events

Limitations

Cas d’utilisation courants

AWS Backup API de notification

Exemples d'événements

Exemple Exemple : tâche de sauvegarde terminée

Exemple Exemple : échec de la tâche de sauvegarde

Exemple Exemple : la tâche de sauvegarde n'a pas pu être terminée pendant la fenêtre de sauvegarde

Exemple Exemple : indexation des points de récupération terminée

Exemple Exemple : échec de l'objet de sauvegarde EKS

Exemple Exemple : échec de l'objet de restauration EKS

Exemple Exemple : objet de restauration EKS ignoré

Exemple Exemple : point d'accès disponible

Exemple Exemple : échec de la création du point d'accès

Exemple Exemple : le point d'accès a expiré

AWS Backup exemples de commandes de notification

Exemple de notification de mise en place d'un coffre-fort de sauvegarde

Exemple de notification d'obtention d'un coffre-fort de sauvegarde

Exemple de notification de suppression d'un coffre-fort de sauvegarde

Spécifier AWS Backup en tant que directeur de service

Note

Note