DynamoDB BackupNotFoundException
TL;DR — DynamoDB 沒有與你提供的 BackupArn 匹配的備份。幾乎總是 ARN 錯誤或格式不對、備份已刪除或過期,或者用戶端指向了錯誤的區域/帳戶。列出該表的備份並複製確切的 ARN。
這是什麼意思
BackupNotFoundException: Backup not found for the given BackupARN.恢復和描述類呼叫(RestoreTableFromBackup、DescribeBackup、DeleteBackup)透過 ARN 定位備份。這個 HTTP 400 意味著在你的憑證解析到的區域 + 帳戶中,該 ARN 上不存在任何備份。它是用戶端錯誤,在 ARN 正確之前不可重試。
為什麼會發生
- ARN 錯誤或格式不對——拼寫錯誤、被截斷的 ARN,或者是手工拼出而非從
list-backups複製的。 - 備份已刪除或過期——有人移除了按需備份、AWS Backup 生命週期規則讓它過期,或者它是一個
SYSTEM備份(在刪除啟用了 PITR 的表時自動建立),會在建立後 35 天過期。 - 區域不對——
list-backups/describe-backup是分割槽域的;備份位於它被建立的區域(嵌在其 ARN 中的區域),因此指向別處的用戶端看不到它。 - 帳戶不對——憑證解析到的 AWS 帳戶不是擁有該備份的那個。
- 由 AWS Backup 管理的恢復點——透過 AWS Backup 計劃的備份以恢復點形式儲存在 AWS Backup 保管庫中,那裡的生命週期規則可以轉換或刪除它們;如果備份不在你預期的位置,檢查一下 AWS Backup 主控台。
如何修正
- 列出該表的備份並取得真實的 ARN:
aws dynamodb list-backups --table-name <Table> --region <r> - 核實它存在且可用:
aws dynamodb describe-backup --backup-arn <arn> --region <r>BackupStatus應為AVAILABLE——一個正處於建立/刪除/恢復中的備份會以 BackupInUseException 拒絕相互衝突的呼叫。 - 把區域固定到備份 ARN 中的那個(備份被建立的區域)。
- 用
aws sts get-caller-identity確認帳戶。 - 備份是由某個 AWS Backup 計劃建立的嗎? 在 AWS Backup 主控台中查詢它(其保管庫的恢復點)——那裡的生命週期規則可以按計劃轉換或刪除備份。
從 DynoTable 連線
DynoTable 是一個表工作臺,而不是備份主控台 — 在呼叫 RestoreTableFromBackup 之前,用它來確認你要恢復到的區域中存在活動表。開啟目標區域設定檔案(⌘P),⌘K→按名稱開啟表,並使用設定檔案晶片上的憑證狀態驗證帳戶。如果恢復失敗並出現 BackupNotFoundException,則 ARN 錯誤或已過期;在AWS備份/DynamoDB備份API中修復該問題,然後返回DynoTable檢查恢復的表架構和項目。 item size calculator 有助於健全性檢查恢復後的物品形狀是否仍然適合你的容量計劃。
來源
- DescribeBackup — Amazon DynamoDB API Reference(2026-07-13 驗證)
- Restoring a DynamoDB table from a backup(2026-07-13 驗證)
相關錯誤
- BackupInUseException——備份存在,但一個相互衝突的備份操作仍在執行。
- ResourceNotFoundException——在該區域/帳戶中找不到表本身。
- Table already exists——恢復的目標表名已被佔用。
- 學習:Backups & point-in-time recovery
參考資料
- DescribeBackup — Amazon DynamoDB API Reference
- RestoreTableFromBackup — Amazon DynamoDB API Reference
- DeleteBackup — Amazon DynamoDB API Reference
- Restoring a DynamoDB table from a backup — Amazon DynamoDB Developer Guide
- Using AWS Backup with DynamoDB — Amazon DynamoDB Developer Guide
- Enable point-in-time recovery in DynamoDB — Amazon DynamoDB Developer Guide
最後核實於 2026-07-13,依據上方連結的 AWS 官方文件。