本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
PutBackupVaultNotifications
開啟指定主題與事件的備份保存庫通知。
請求語法
PUT /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
Content-type: application/json
{
"BackupVaultEvents": [ "string" ],
"SNSTopicArn": "string"
}URI 請求參數
請求會使用下列 URI 參數。
- backupVaultName
-
存放備份的邏輯容器的名稱。備份文件庫依名稱識別，這些名稱對建立文件庫的帳戶和 AWS 區域來說是唯一的。
模式：
^[a-zA-Z0-9\-\_]{2,50}$必要：是
請求主體
請求接受採用 JSON 格式的下列資料。
- BackupVaultEvents
-
事件陣列，指示將資源備份到備份文件庫的任務狀態。
如需常見使用案例和程式碼範例，請參閱使用 Amazon SNS 追蹤 AWS Backup 事件。
支援的事件如下：
-
BACKUP_JOB_STARTED|BACKUP_JOB_COMPLETED -
COPY_JOB_STARTED|COPY_JOB_SUCCESSFUL|COPY_JOB_FAILED -
RESTORE_JOB_STARTED|RESTORE_JOB_COMPLETED|RECOVERY_POINT_MODIFIED -
S3_BACKUP_OBJECT_FAILED|S3_RESTORE_OBJECT_FAILED
注意
下列清單包含不再使用的受支援事件和已停用的事件 (供參考)。已取代的事件不會傳回狀態或通知。有關支持的事件，請參閱上面的列表。
類型：字串陣列
有效值:
BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED | COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED | RECOVERY_POINT_MODIFIED | BACKUP_PLAN_CREATED | BACKUP_PLAN_MODIFIED | S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED必要：是
-
- SNSTopicArn
-
可指定備份保存庫事件主題的 Amazon Resource Name (ARN)，例如
arn:aws:sns:us-west-2:111122223333:MyVaultTopic。類型：字串
必要：是
回應語法
HTTP/1.1 200
回應元素
如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InvalidParameterValueException
-
表示參數的值出現問題。例如，值超出範圍。
HTTP 狀態碼：400
- MissingParameterValueException
-
表示缺少必要的參數。
HTTP 狀態碼：400
- ResourceNotFoundException
-
動作所需的資源不存在。
HTTP 狀態碼：400
- ServiceUnavailableException
-
由於伺服器發生臨時故障，請求失敗。
HTTP 狀態碼：500
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：
