View a markdown version of this page

Opsi notifikasi dengan AWS Backup - AWS Backup
Notifikasi Pengguna dan AWS BackupAmazon SNS dan acara AWS Backup

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Opsi notifikasi dengan AWS Backup

Ada dua cara untuk menerima pemberitahuan tentang AWS Backup:

  • Notifikasi Pengguna dapat mengirim notifikasi, termasuk CloudWatch alarm Amazon AWS Dukungan, dan pemberitahuan layanan lainnya.

  • Layanan Pemberitahuan Sederhana Amazon dapat memberi tahu Anda tentang AWS Backup peristiwa.

Notifikasi Pengguna and AWS Backup

AWS Backup mendukung pengelolaan pemberitahuan cadangan Anda dari Notifikasi Pengguna konsol. Dengan Notifikasi Pengguna, Anda dapat melihat kemajuan pekerjaan pencadangan, penyalinan, dan pemulihan serta perubahan kebijakan cadangan, brankas, titik pemulihan, dan pengaturan dari Pusat Pemberitahuan Pengguna.

Amazon CloudWatch, EventBridge alarm Amazon, dan pembaruan AWS Dukungan kasus adalah di antara jenis pemberitahuan lain yang dapat Anda kelola dari konsol. Selain itu, Anda dapat mengatur beberapa opsi pengiriman, termasuk email, Amazon Q Developer dalam pemberitahuan aplikasi obrolan, dan pemberitahuan AWS Console Mobile Application push.

Amazon SNS dan AWS Backup peristiwa

AWS Backup memanfaatkan notifikasi kuat yang dikirimkan oleh Amazon Simple Notification Service (Amazon SNS). Anda dapat mengonfigurasi Amazon SNS untuk memberi tahu Anda tentang AWS Backup peristiwa dari konsol Amazon SNS.

Batasan

  • Meskipun layanan Amazon SNS memungkinkan pemberitahuan lintas akun, saat ini AWS Backup tidak mendukung fitur ini. Anda harus menentukan ID AWS akun Anda sendiri dan ARN sumber daya topik Anda.

  • AWS Backup mendukung topik Standar untuk deduplikasi upaya terbaik SNS, tetapi saat ini AWS Backup tidak mendukung topik SNS FIFO untuk deduplikasi ketat.

Kasus penggunaan umum

Untuk informasi selengkapnya tentang Amazon SNS secara umum, lihat Mem ulai dengan Amazon SNS di Panduan Pengembang Layanan Pem beritahuan Sederhana Amazon.

AWS Backup API notifikasi

Setelah membuat topik menggunakan konsol Amazon SNS atau AWS Command Line Interface (AWS CLI), Anda dapat menggunakan operasi AWS Backup API berikut untuk mengelola pemberitahuan cadangan Anda.

AWS Backup mendukung acara berikut:

Jenis Tugas Peristiwa
Pekerjaan cadangan BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | CONTINUOUS_BACKUP_INTERRUPTED
Salin pekerjaan COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED
Kembalikan pekerjaan RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED
Titik pemulihan RECOVERY_POINT_MODIFIED
Pengindeksan titik pemulihan RECOVERY_POINT_INDEX_COMPLETED | RECOVERY_POINT_INDEX_DELETED | RECOVERY_POINT_INDEXING_FAILED
Titik akses ACCESS_POINT_AVAILABLE | ACCESS_POINT_CREATION_FAILED | ACCESS_POINT_DELETED | ACCESS_POINT_DELETION_FAILED | ACCESS_POINT_EXPIRED | ACCESS_POINT_DISASSOCIATED

AWS Backup untuk S3 mendukung dua acara tambahan:

  • S3_BACKUP_OBJECT_FAILEDmemberi tahu Anda tentang objek S3 apa pun yang AWS Backup gagal dicadangkan selama pekerjaan pencadangan.

  • S3_RESTORE_OBJECT_FAILEDmemberi tahu Anda tentang objek S3 yang AWS Backup gagal dipulihkan selama pekerjaan pemulihan.

AWS Backup untuk EKS mendukung tiga acara tambahan:

  • EKS_BACKUP_OBJECT_FAILEDmemberi tahu Anda tentang objek EKS yang AWS Backup gagal dicadangkan selama pekerjaan pencadangan.

  • EKS_RESTORE_OBJECT_FAILEDmemberi tahu Anda tentang objek EKS yang AWS Backup gagal dipulihkan selama pekerjaan pemulihan.

  • EKS_RESTORE_OBJECT_SKIPPEDmemberi tahu Anda tentang objek EKS apa pun yang dil AWS Backup ewati selama pekerjaan pemulihan.

Contoh acara

contoh Contoh: Pekerjaan pencadangan selesai
{
    "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"}
            }
        }
    }]
}
contoh Contoh: Pekerjaan pencadangan gagal
{
    "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"}
            }
        }
    }]
}
contoh Contoh: Pekerjaan pencadangan tidak dapat diselesaikan selama jendela pencadangan
{
    "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"}
            }
        }
    }]
}
contoh Contoh: Pengindeksan titik pemulihan selesai
{
    "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"}
            }
        }
    }]
}
contoh Contoh: Objek cadangan EKS gagal
{
    "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"}
            }
        }
    }]
}
contoh Contoh: Objek pemulihan EKS gagal
{
    "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"}
            }
        }
    }]
}
contoh Contoh: Objek pemulihan EKS dilewati
{
    "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"}
            }
        }
    }]
}
contoh Contoh: Titik akses tersedia
{
    "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"}
    }
}
contoh Contoh: Pembuatan titik akses gagal
{
    "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"}
    }
}
contoh Contoh: Titik akses kedaluwarsa
{
    "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 contoh perintah notifikasi

Anda dapat menggunakan AWS CLI perintah untuk berlangganan, membuat daftar, dan menghapus notifikasi Amazon SNS untuk AWS Backup acara Anda.

Contoh menempatkan pemberitahuan brankas cadangan

Perintah berikut berlangganan topik Amazon SNS untuk brankas cadangan tertentu yang memberi tahu Anda saat pekerjaan pemulihan dimulai atau selesai, atau ketika titik pemulihan dimodifikasi.

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

Contoh mendapatkan pemberitahuan brankas cadangan

Perintah berikut mencantumkan semua acara yang saat ini berlangganan topik Amazon SNS untuk brankas cadangan yang ditentukan.

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

Output sampel adalah sebagai berikut:

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

Contoh menghapus pemberitahuan brankas cadangan

Perintah berikut berhenti berlangganan dari topik Amazon SNS untuk brankas cadangan yang ditentukan.

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

Menentukan AWS Backup sebagai prinsipal layanan

catatan

AWS Backup Untuk mengizinkan menerbitkan topik SNS atas nama Anda, Anda harus menentukan AWS Backup sebagai prinsipal layanan.

Sertakan JSON berikut dalam kebijakan akses topik Amazon SNS yang Anda gunakan untuk melacak AWS Backup peristiwa. Anda harus menentukan sumber daya Amazon Resource Name (ARN) dari topik Anda.

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

Untuk informasi selengkapnya tentang menentukan prinsip layanan dalam kebijakan akses Amazon SNS, lihat Mengizinkan Sumber Daya Apa pun untuk AWS Dipublikasikan ke Topik di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

catatan

Jika topik Anda dienkripsi, Anda harus menyertakan izin tambahan dalam kebijakan Anda untuk mengizinkan AWS Backup publikasi ke topik tersebut. Untuk informasi selengkapnya tentang mengaktifkan layanan untuk menerbitkan ke topik terenkripsi, lihat Meng aktifkan Kompatibilitas antara Sumber Peristiwa dari AWS Layanan dan Topik Terenkripsi di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.