기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 를 사용한 알림 옵션 AWS Backup
AWS Backup다음 두 가지 방법으로 알림을 받을 수 있습니다.
+ User Notifications 는 Amazon CloudWatch 경보 AWS Support및 기타 서비스 알림을 포함한 알림을 보낼 수 있습니다.
+ Amazon Simple Notification Service는 AWS Backup 이벤트를 알릴 수 있습니다.
## User Notifications 및 AWS Backup
AWS Backup 는 [User Notifications 콘솔](https://console.aws.amazon.com//notifications/home?notifications#/notifications)에서 백업 알림 관리를 지원합니다. [User Notifications](https://docs.aws.amazon.com/notifications/latest/userguide/getting-started.html)을 사용하면 사용자 알림 센터에서 백업, 복사, 복원 작업의 진행 상황과 백업 정책, 저장소, 복구 시점, 설정에 대한 변경 사항을 볼 수 있습니다.
Amazon CloudWatch, Amazon EventBridge 경보 및 AWS Support 사례 업데이트는 콘솔에서 관리할 수 있는 다른 유형의 알림입니다. 또한 이메일, 채팅 애플리케이션 알림의 Amazon Q Developer, AWS Console Mobile Application 푸시 알림 등 여러 전송 옵션을 설정할 수 있습니다.
## Amazon SNS 및 AWS Backup 이벤트
AWS Backup 는 Amazon Simple Notification Service(Amazon SNS)에서 제공하는 강력한 알림을 활용합니다. Amazon SNS 콘솔에서 AWS Backup 이벤트를 알리도록 Amazon SNS를 구성할 수 있습니다.
**제한 사항**
+ Amazon SNS 서비스는 교차 계정 알림을 허용하지만 AWS Backup 는 현재이 기능을 지원하지 않습니다. 고유한 AWS 계정 ID와 주제의 리소스 ARN을 지정해야 합니다.
+ AWS Backup 는 SNS 최선의 중복 제거를 위한 표준 주제를 지원하지만, 현재 엄격한 중복 제거를 위한 SNS FIFO 주제 AWS Backup 는 지원하지 않습니다.
### 일반 사용 사례
+ 실패한 작업에 대한 알림을 [받으려면 어떻게 해야 합니까?의 단계에 따라 실패한 백업 AWS Backup 작업에 대한 알림을](https://repost.aws/knowledge-center/aws-backup-failed-job-notification) 설정합니다. AWS Premium Support에서.
+ 아래의 이벤트 예제 표에서 완료, 실패, 만료된 백업 작업에 대한 Amazon SNS 알림 JSON 샘플을 검토합니다.
Amazon SNS에 대한 전반적인 자세한 내용은 **Amazon Simple Notification Service 개발자 안내서의 [Amazon SNS 시작하기](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)를 참조하세요.
### AWS Backup 알림 APIs
Amazon SNS 콘솔 또는 AWS Command Line Interface (AWS CLI)를 사용하여 주제를 생성한 후 다음 AWS Backup API 작업을 사용하여 백업 알림을 관리할 수 있습니다.
+ [DeleteBackupVaultNotifications](API_DeleteBackupVaultNotifications.md) — 지정된 백업 저장소에 대한 이벤트 알림을 삭제합니다.
+ [GetBackupVaultNotifications](API_GetBackupVaultNotifications.md) — 지정된 백업 저장소에 대한 이벤트 알림을 모두 나열합니다.
+ [PutBackupVaultNotifications](API_PutBackupVaultNotifications.md) — 지정된 주제 및 이벤트에 대한 알림을 설정합니다.
AWS Backup 는 다음 이벤트를 지원합니다.
| 작업 유형 | Event |
| --- | --- |
| 백업 작업 | BACKUP\$1JOB\$1STARTED \$1 BACKUP\$1JOB\$1COMPLETED \$1 CONTINUOUS\$1BACKUP\$1INTERRUPTED |
| 복사 작업 | COPY\$1JOB\$1STARTED \$1 COPY\$1JOB\$1SUCCESSFUL \$1 COPY\$1JOB\$1FAILED |
| 복원 작업 | RESTORE\$1JOB\$1STARTED \$1 RESTORE\$1JOB\$1COMPLETED |
| 복구 시점 | RECOVERY\$1POINT\$1MODIFIED |
| 복구 시점 인덱싱 | RECOVERY\$1POINT\$1INDEX\$1COMPLETED \$1 RECOVERY\$1POINT\$1INDEX\$1DELETED \$1 RECOVERY\$1POINT\$1INDEXING\$1FAILED |
AWS Backup for S3는 두 가지 추가 이벤트를 지원합니다.
+ `S3_BACKUP_OBJECT_FAILED`는 백업 작업 도중 AWS Backup 에서 백업에 실패한 모든 S3 객체를 사용자에게 알립니다.
+ `S3_RESTORE_OBJECT_FAILED`는 복원 작업 도중 AWS Backup 에서 복원에 실패한 모든 S3 객체를 사용자에게 알립니다.
AWS Backup EKS용는 세 가지 추가 이벤트를 지원합니다.
+ `EKS_BACKUP_OBJECT_FAILED`는 백업 작업 중에 백업에 실패한 모든 EKS 객체 AWS Backup 를 알려줍니다.
+ `EKS_RESTORE_OBJECT_FAILED`는 복원 작업 중에 복원에 실패한 모든 EKS 객체 AWS Backup 를 알려줍니다.
+ `EKS_RESTORE_OBJECT_SKIPPED`는 복원 작업 중에 건너뛴 모든 EKS 객체 AWS Backup 를 알려줍니다.
### 이벤트 예제
**Example 예: 백업 작업 완료**
```
{
"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"}
}
}
}]
}
```
**Example 예: 백업 작업 실패**
```
{
"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"}
}
}
}]
}
```
**Example 예: 백업 기간 동안 백업 작업을 완료할 수 없음**
```
{
"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"}
}
}
}]
}
```
**Example 예: 복구 시점 인덱싱 완료**
```
{
"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"}
}
}
}]
}
```
**Example 예: 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"}
}
}
}]
}
```
**Example 예: 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"}
}
}
}]
}
```
**Example 예: 건너뛴 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 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"}
}
}
}]
}
```
### AWS Backup 알림 명령 예제
AWS CLI 명령을 사용하여 AWS Backup 이벤트에 대한 Amazon SNS 알림을 구독, 나열 및 삭제할 수 있습니다.
#### 백업 저장소 알림 넣기 예
다음 명령은 복원 작업이 시작되거나 완료될 때 또는 복구 시점이 수정될 때 알려주도록 지정된 백업 저장소에 대한 Amazon SNS 주제를 구독합니다.
```
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
```
#### 백업 저장소 알림 가져오기 예
다음 명령은 지정된 백업 저장소의 Amazon SNS 주제를 현재 구독하고 있는 모든 이벤트를 나열합니다.
```
aws backup get-backup-vault-notifications
--backup-vault-name myVault
```
샘플 출력은 다음과 같습니다.
```
{
"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"
}
```
#### 백업 저장소 알림 삭제 예
다음 명령은 지정된 백업 저장소에 대한 Amazon SNS 주제의 구독을 취소합니다.
```
aws backup delete-backup-vault-notifications
--backup-vault-name myVault
```
### 서비스 보안 주체 AWS Backup 로 지정
**참고**
AWS Backup 가 사용자를 대신하여 SNS 주제를 게시하도록 허용하려면를 서비스 보안 주체 AWS Backup 로 지정해야 합니다.
AWS Backup 이벤트를 추적하는 데 사용하는 Amazon SNS 주제의 액세스 정책에 다음 JSON을 포함합니다. 주제의 리소스 Amazon 리소스 이름(ARN)을 지정해야 합니다.
```
{
"Sid": "My-statement-id",
"Effect": "Allow",
"Principal": {
"Service": "backup.amazonaws.com"
},
"Action": "SNS:Publish",
"Resource": "arn:aws:sns:region:account-id:myTopic"
}
```
Amazon SNS 액세스 정책에서 서비스 보안 주체를 지정하는 방법에 대한 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [모든 AWS 리소스가 주제에 게시하도록 허용을 참조하세요](https://docs.aws.amazon.com/sns/latest/dg/AccessPolicyLanguage_UseCases_Sns.html#AccessPolicyLanguage_UseCase4_Sns).
**참고**
주제가 암호화된 경우가 주제에 AWS Backup 게시할 수 있도록 정책에 추가 권한을 포함해야 합니다. 서비스가 암호화된 주제에 게시할 수 있도록 하는 방법에 대한 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [AWS 서비스의 이벤트 소스와 암호화된 주제 간의 호환성 활성화](https://docs.aws.amazon.com//sns/latest/dg/sns-key-management.html#sns-what-permissions-for-sse)를 참조하세요.