DynamoDB BackupNotFoundException
TL;DR — DynamoDB não possui backup correspondente ao BackupArn que você forneceu. Quase sempre um ARN errado ou malformado, um backup que foi excluído ou expirou ou um cliente apontou para a região /account errada. Liste os backups da tabela e copie o ARN exato.
O que significa
BackupNotFoundException: Backup not found for the given BackupARN.As chamadas de restauração e descrição (RestoreTableFromBackup, DescribeBackup, DeleteBackup) endereçam um backup por seu ARN. Este HTTP 400 significa que não existe backup naquele ARN na região + conta para a qual suas credenciais são resolvidas. É do lado do cliente e não pode ser repetido até que o ARN esteja correto.
Por que isso acontece
- ARN errado ou malformado — um erro de digitação, um ARN truncado ou um construído à mão em vez de copiado do
list-backups. - O backup foi excluído ou expirou — alguém removeu o backup on-demand, uma regra de ciclo de vida do backup AWS expirou ou era um backup
SYSTEM(criado automaticamente quando uma tabela com PITR habilitado é excluída), que expira 35 dias após a criação. - Região errada —
list-backups/describe-backupsão regionais; o backup reside na região onde foi criado (a região incorporada em seu ARN), portanto, um cliente apontado para outro lugar não pode vê-lo. - Conta errada — as credenciais são resolvidas para uma conta AWS diferente daquela que possui o backup.
- Ponto de recuperação gerenciado pelo AWS Backup — os backups agendados por meio do AWS Backup são armazenados como pontos de recuperação em um cofre do AWS Backup, onde as regras de ciclo de vida podem fazer a transição ou excluí-los; verifique o console de backup do AWS se o backup não estiver onde você espera.
Como corrigir
- Liste os backups da tabela e pegue o ARN real:
aws dynamodb list-backups --table-name <Table> --region <r> - Verifique se ele existe e está disponível:
aws dynamodb describe-backup --backup-arn <arn> --region <r>BackupStatusdeve serAVAILABLE— um backup em meio a criação/exclusão/restauração rejeita chamadas conflitantes com BackupInUseException. - Fixe a região àquela do ARN do backup (onde o backup foi criado).
- Confirme a conta com
aws sts get-caller-identity. - Backup feito por um plano do AWS Backup? Procure no console do AWS Backup (os pontos de recuperação do cofre) — as regras de ciclo de vida podem fazer a transição ou excluir backups de acordo com uma programação.
Conecte pelo DynoTable
DynoTable é um ambiente de trabalho de tabela, não um console de backup — use-o para confirmar se a tabela ativa existe na região na qual você pretende restaurar antes de chamar RestoreTableFromBackup. Abra o perfil da região de destino (⌘P), ⌘K → abra a tabela por nome e verifique a conta com o status da credencial no chip do perfil.
Se a restauração falhar com BackupNotFoundException, o ARN está errado ou expirou; corrija isso no backup AWS / backup DynamoDB APIs e, em seguida, volte ao DynoTable para inspecionar o esquema e os itens da tabela restaurada. A calculadora de tamanho de item ajuda a verificar se o formato de um item restaurado ainda se ajusta ao seu plano de capacidade.
Fontes
- DescribeBackup — Referência Amazon DynamoDB API (verificado em 13/07/2026)
- Restaurando uma tabela DynamoDB de um backup (verificado em 13/07/2026)
Erros relacionados
- BackupInUseException — o backup existe, mas uma operação de backup conflitante ainda está em execução.
- ResourceNotFoundException — a tabela em si não pode ser encontrada na região/account.
- A tabela já existe — o nome da tabela de destino da restauração é obtido. Aprenda: Backups e recuperação pontual
Referências
- DescribeBackup – Referência do Amazon DynamoDB API
- RestoreTableFromBackup — Referência do Amazon DynamoDB API
- DeleteBackup – Referência do Amazon DynamoDB API
- Restaurar uma tabela DynamoDB de um backup — Guia do desenvolvedor do Amazon DynamoDB
- Usando o backup do AWS com o DynamoDB — Guia do desenvolvedor do Amazon DynamoDB
- Ativar recuperação pontual no DynamoDB — Guia do desenvolvedor do Amazon DynamoDB
Última verificação em 13/07/2026 em relação à documentação oficial do AWS vinculada acima.