ConfigError: região ausente na configuração

TL;DR — O SDK AWS não sabe com qual região falar. Defina-o explicitamente no cliente (new DynamoDBClient({ region: 'us-east-1' })), ou por meio da variável de ambiente AWS_REGION, ou em ~/.aws/config.

O que significa

ConfigError: Missing region in config

Cada endpoint DynamoDB é regional, portanto, o SDK deve resolver uma região antes de poder enviar uma solicitação. Este texto exato vem do SDK AWS para JavaScript v2 (agora em fim de suporte), que não seleciona uma região por padrão - quando nenhuma de suas fontes de configuração fornece uma, ele a lança antes de qualquer chamada de rede. Outros SDKs e a CLI do AWS falham com seus próprios equivalentes quando nenhuma região está configurada.

Por que isso acontece

Nenhuma região passada para o cliente e nenhum AWS_REGION no ambiente (o JavaScript SDK lê AWS_REGION; a CLI do AWS também respeita AWS_DEFAULT_REGION e --region).
Uma região no ~/.aws/config que o SDK nunca lê — o JavaScript SDK v2 só carrega o arquivo de configuração compartilhado quando a variável de ambiente AWS_SDK_LOAD_CONFIG é definida; sem ele, uma linha region = perfeitamente boa é ignorada.
Um erro de digitação no nome da variável do ambiente (AWS_REGIONS, REGION).

Como corrigir (qualquer um destes)

Configure no cliente (mais explícito):

import {DynamoDBClient} from '@aws-sdk/client-dynamodb';
const client = new DynamoDBClient({region: 'us-east-1'});

Variável de ambiente:
```
export AWS_REGION=us-east-1
```
Arquivo de configuração AWS (~/.aws/config):
```
[default]
region = us-east-1
```
No SDK JavaScript v2, defina também AWS_SDK_LOAD_CONFIG=1 para que o SDK realmente leia esse arquivo (a CLI e a maioria dos outros SDKs o leem por padrão).
DynamoDB Local? Ele ainda precisa de alguma string de região (qualquer valor — ela só serve para nomear o arquivo de banco de dados local) mais um endpoint:
```
const client = new DynamoDBClient({region: 'local', endpoint: 'http://localhost:8000'});
```

Aponte o DynoTable para o Local

O DynoTable armazena a região em cada perfil AWS - Configurações → Perfis → Adicionar perfil e, em seguida, escolha a região no menu suspenso antes de salvar. O chip de perfil na parte inferior da barra lateral mostra a região ativa; pressione ⌘P para alternar. A conexão de teste falha rapidamente quando a região está em branco ou o arquivo de configuração compartilhado é ignorado por um SDK que precisa de AWS_SDK_LOAD_CONFIG.

Para Local, use Download Local (ou aponte o endpoint do perfil para http://localhost:8000) e defina qualquer string de região — DynoTable mantém o endpoint e a região no mesmo perfil para que eles não possam desviar. Uma vez conectado, abra uma tabela com ⌘K e confirme se a solicitação vai para a região que você espera. O construtor de consultas visual é útil para provar a região do perfil antes de colar as mesmas configurações no código do aplicativo.

Ao depurar diferenças de resolução de região entre SDK v2 e v3, compare as configurações de perfil que o DynoTable usa com os env vars do seu aplicativo lado a lado. O preparo (⌘S) permite testar uma gravação no perfil configurado antes da execução da tarefa em lote.

Fontes

Configurando a região AWS — SDK AWS para JavaScript v2 (verificado em 13/07/2026)
Solução de erros para a CLI AWS (verificado em 13/07/2026)

Erros relacionados

O token de segurança é inválido
ResourceNotFoundException — geralmente uma incompatibilidade de região quando uma região é definida.
Não é possível iniciar o processo local do DynamoDB Aprenda: Conecte-se ao DynamoDB Local e LocalStack

Referências

Última verificação em 13/07/2026 em relação à documentação oficial do AWS vinculada acima.