View a markdown version of this page

Opzioni di notifica con AWS Backup - AWS Backup
Notifiche all'utente e AWS BackupAmazon SNS ed eventi AWS Backup

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Opzioni di notifica con AWS Backup

Esistono due modi per ricevere notifiche su AWS Backup:

  • Notifiche all'utente può inviare notifiche, inclusi CloudWatch allarmi Amazon e notifiche di altri servizi. Supporto AWS

  • Amazon Simple Notification Service può notificarti gli eventi. AWS Backup

Notifiche all'utente and AWS Backup

AWS Backup supporta la gestione delle notifiche di backup dalla Notifiche all'utente console. Con Notifiche all'utente, è possibile visualizzare lo stato di avanzamento dei processi di backup, copia e ripristino e le modifiche alle politiche di backup, agli archivi, ai punti di ripristino e alle impostazioni dal Centro notifiche utente.

Amazon CloudWatch, gli EventBridge allarmi Amazon e gli aggiornamenti dei Supporto AWS casi sono tra gli altri tipi di notifiche che puoi gestire dalla console. Inoltre, puoi configurare diverse opzioni di consegna, tra cui e-mail, notifiche delle applicazioni Amazon Q Developer in chat e notifiche AWS Console Mobile Application push.

Amazon SNS e AWS Backup eventi

AWS Backup sfrutta le solide notifiche fornite da Amazon Simple Notification Service (Amazon SNS). Puoi configurare Amazon SNS per notificarti AWS Backup gli eventi dalla console Amazon SNS.

Limitazioni

  • Sebbene il servizio Amazon SNS consenta le notifiche tra più account, al momento non AWS Backup supporta questa funzionalità. Devi specificare l'ID del tuo AWS account e l'ARN della risorsa del tuo argomento.

  • AWS Backup supporta gli argomenti standard per la deduplicazione semplificata di SNS, ma attualmente non AWS Backup supporta gli argomenti SNS FIFO per la deduplicazione rigorosa.

Casi di utilizzo comune

  • Configura le notifiche per i processi di backup non riusciti seguendo la procedura descritta in Come posso ricevere notifiche per i processi non riusciti? AWS Backupdall'assistenza AWS Premium.

  • Consulta JSON di notifica Amazon SNS di esempio per i processi di backup completati, non riusciti e scaduti nella tabella di esempi di eventi riportata di seguito.

Per ulteriori informazioni generali su Amazon SNS, consulta Nozioni di base su Amazon SNS nella Guida per gli sviluppatori di Amazon Simple Notification Service.

AWS Backup API di notifica

Dopo aver creato gli argomenti utilizzando la console Amazon SNS o AWS Command Line Interface (AWS CLI), puoi utilizzare le seguenti operazioni AWS Backup API per gestire le notifiche di backup.

AWS Backup supporta i seguenti eventi:

Tipo di processo Event
Processo di backup BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | CONTINUOUS_BACKUP_INTERRUPTED
Processo di copia COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED
Processo di ripristino RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED
Punto di ripristino RECOVERY_POINT_MODIFIED
Indicizzazione dei punti di ripristino RECOVERY_POINT_INDEX_COMPLETED | RECOVERY_POINT_INDEX_DELETED | RECOVERY_POINT_INDEXING_FAILED
Access point ACCESS_POINT_AVAILABLE | ACCESS_POINT_CREATION_FAILED | ACCESS_POINT_DELETED | ACCESS_POINT_DELETION_FAILED | ACCESS_POINT_EXPIRED | ACCESS_POINT_DISASSOCIATED

AWS Backup per S3 supporta due eventi aggiuntivi:

  • S3_BACKUP_OBJECT_FAILED invia all'utente una notifica relativa a tutti oggetti S3 di cui AWS Backup non è riuscito a eseguire il backup durante un processo di backup.

  • S3_RESTORE_OBJECT_FAILED invia all'utente una notifica relativa a tutti gli oggetti S3 di cui AWS Backup non è riuscito a eseguire il ripristino durante un processo di ripristino.

AWS Backup for EKS supporta tre eventi aggiuntivi:

  • EKS_BACKUP_OBJECT_FAILEDnotifica all'utente eventuali oggetti EKS di cui AWS Backup non è stato eseguito il backup durante un processo di backup.

  • EKS_RESTORE_OBJECT_FAILEDavvisa l'utente di eventuali oggetti EKS che AWS Backup non sono stati ripristinati durante un processo di ripristino.

  • EKS_RESTORE_OBJECT_SKIPPEDavvisa l'utente di eventuali oggetti EKS AWS Backup saltati durante un processo di ripristino.

Esempi di eventi

Esempio Esempio: processo di backup completato
{
    "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"}
            }
        }
    }]
}
Esempio Esempio: processo di backup non riuscito
{
    "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"}
            }
        }
    }]
}
Esempio Esempio: il processo di backup non può essere completato durante la finestra di backup
{
    "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"}
            }
        }
    }]
}
Esempio Esempio: indicizzazione dei punti di ripristino completata
{
    "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"}
            }
        }
    }]
}
Esempio Esempio: oggetto di backup EKS non riuscito
{
    "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"}
            }
        }
    }]
}
Esempio Esempio: oggetto di ripristino EKS non riuscito
{
    "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"}
            }
        }
    }]
}
Esempio Esempio: oggetto di ripristino EKS saltato
{
    "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"}
            }
        }
    }]
}
Esempio Esempio: punto di accesso disponibile
{
    "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"}
    }
}
Esempio Esempio: creazione del punto di accesso non riuscita
{
    "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"}
    }
}
Esempio Esempio: punto di accesso scaduto
{
    "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 esempi di comandi di notifica

Puoi utilizzare AWS CLI i comandi per iscriverti, elencare ed eliminare le notifiche di Amazon SNS per i tuoi AWS Backup eventi.

Esempio di notifica put del vault di backup

Il comando seguente effettua la sottoscrizione a un argomento Amazon SNS per il vault di backup specificato che notifica l'avvio o il completamento di un processo di ripristino o la modifica di un punto di ripristino.

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

Esempio di notifica get del vault di backup

Il comando seguente elenca tutti gli eventi che hanno attualmente effettuato la sottoscrizione ad un argomento Amazon SNS per il vault di backup specificato.

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

Di seguito è riportato l'output di esempio:

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

Esempio di notifica delete del vault di back

Il comando seguente annulla la sottoscrizione a un argomento Amazon SNS per il vault di backup specificato.

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

Specificare AWS Backup come responsabile del servizio

Nota

AWS Backup Per consentire la pubblicazione di argomenti SNS per tuo conto, devi specificarlo AWS Backup come responsabile del servizio.

Includi il seguente JSON nella politica di accesso dell'argomento Amazon SNS che utilizzi per tracciare gli eventi. AWS Backup È necessario specificare l'Amazon Resource Name (ARN) di risorsa del tuo argomento.

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

Per ulteriori informazioni su come specificare l'entità del servizio in una policy di accesso di Amazon SNS, consulta Allowing Any AWS Resource to Publish to a Topic nella Amazon Simple Notification Service Developer Guide.

Nota

Se il tuo argomento è crittografato, devi includere autorizzazioni aggiuntive nella tua policy per AWS Backup consentirne la pubblicazione. Per ulteriori informazioni su come consentire ai servizi di pubblicare su argomenti crittografati, consulta Abilita la compatibilità tra fonti di eventi provenienti da AWS servizi e argomenti crittografati nella Amazon Simple Notification Service Developer Guide.