翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# を使用した通知オプション AWS Backup
に関する通知を受け取るには、次の 2 つの方法があります AWS Backup。
+ User Notifications は、Amazon CloudWatch アラームなどの通知 AWS サポート、およびその他のサービスの通知を送信できます。
+ 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 サポート ケースの更新は、コンソールから管理できる他のタイプの通知です。さらに、E メール、チャットアプリケーション通知の 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 プレミアムサポートから。
+ 以下の「イベントの例」一覧表で、完了、失敗、期限切れのバックアップジョブのサンプル 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 は、次のイベントをサポートしています。
| ジョブタイプ | イベント |
| --- | --- |
| バックアップジョブ | 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 は 2 つの追加イベントをサポートします。
+ `S3_BACKUP_OBJECT_FAILED` がバックアップジョブ中に AWS Backup がバックアップに失敗した S3 オブジェクトを通知します。
+ `S3_RESTORE_OBJECT_FAILED` が復元ジョブ中に AWS Backup が復元に失敗した S3 オブジェクトを通知します。
AWS Backup for EKS は 3 つの追加イベントをサポートします。
+ `EKS_BACKUP_OBJECT_FAILED` は、バックアップジョブ中にバックアップに失敗した EKS オブジェクト AWS Backup を通知します。
+ `EKS_RESTORE_OBJECT_FAILED` は、復元ジョブ中に復元に失敗した EKS オブジェクト AWS Backup を通知します。
+ `EKS_RESTORE_OBJECT_SKIPPED` は、復元ジョブ中にスキップされた AWS Backup EKS オブジェクトを通知します。
### イベントの例
**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 デベロッパーガイド*」の[「Enable Compatibility between Event Sources from AWS Services and Encrypted Topics](https://docs.aws.amazon.com//sns/latest/dg/sns-key-management.html#sns-what-permissions-for-sse)」を参照してください。