A AWS encerrará em 30 de outubro de 2026 o namespace bedrock-agentcore do AWS Agent Registry. A migração dos registros existentes não é automática: cabe a cada cliente executá-la, e os dados que permanecerem no namespace antigo serão perdidos quando ele for desligado. A AWS descreve três caminhos de migração e mudanças necessárias em código e integrações. Consulte o guia de migração da AWS.
Escolha uma estratégia de migração
A escolha depende de como os registros são usados e de como a equipe pretende fazer a virada. A ferramenta da AWS extrai, transforma e carrega os dados em novos registries na mesma conta e região da AWS.
| Estratégia | Quando considerar | Como funciona |
| Migração pontual local ou pelo AWS CloudShell | Para fazer uma migração completa em uma execução. | A ferramenta é executada em um terminal local ou no CloudShell e extrai, transforma e carrega os registries e registros. |
| Trabalhos gerenciados do AWS Glue | Para executar a migração sem acompanhamento ou fazer uma carga incremental na virada. | Uma pilha CDK fornecida pela AWS configura trabalhos do Glue; a carga incremental pode levar para o novo namespace as alterações posteriores à carga inicial. |
| Active-active | Para registries de produção que continuam recebendo gravações durante a transição. | Depois da migração completa, a aplicação grava nos dois namespaces; após a validação, as leituras e gravações passam para agent-registry. |
Se os dados não mudam durante a migração, a opção pontual evita manter uma estrutura gerenciada para o processo. Para cargas que precisam rodar sem acompanhamento ou receber uma atualização incremental na virada, a AWS descreve o AWS Glue. Já a estratégia active-active atende ao caso de produção com gravações contínuas, pois mantém gravações nos dois namespaces antes da troca de leituras e gravações.
Atualize as integrações além do nome do namespace
Trocar bedrock-agentcore por agent-registry no código não basta. A AWS também lista mudanças em endpoints, permissões e relações de confiança do IAM, ARNs, clientes de SDK, comandos da CLI, esquema da API e integrações de observabilidade e eventos.
Confira os endpoints de dados e de controle usados pela aplicação. O endpoint de dados muda de bedrock-agentcore.{region}.amazonaws.com para agent-registry.{region}.api.aws; o de controle, de bedrock-agentcore-control.{region}.amazonaws.com para agent-registry-control.{region}.api.aws. Os clientes de SDK passam de BedrockAgentCoreClient e BedrockAgentCoreControlClient para AgentRegistryClient e AgentRegistryControlClient. Na CLI, aws bedrock-agentcore dá lugar a aws agent-registry.
O esquema das APIs também muda de forma incompatível com versões anteriores. O código que monta requisições ou interpreta respostas precisa acompanhar, entre outras alterações, os campos obrigatórios name e recordType. inlineContent passa a se chamar data; schemaVersion e protocolVersion dão lugar a dataSchemaVersion; e source, usado na sincronização, passa para os descritores.
Revise também as permissões e os recursos associados ao namespace. O prefixo de ações IAM do Registry muda de bedrock-agentcore:* para agent-registry:*, e o principal de serviço passa de bedrock-agentcore.amazonaws.com para agent-registry.amazonaws.com. A política gerenciada BedrockAgentCoreFullAccess não recebe automaticamente permissões agent-registry:*; a AWS indica AgentRegistryFullAccess para acesso ao Registry.
Essa troca não se aplica indiscriminadamente a todas as permissões antigas. Recursos de workload identity e de provedores de credenciais OAuth continuam sob bedrock-agentcore. Nas integrações de observabilidade e eventos, atualize o namespace do CloudWatch de AWS/BedrockAgentCore para AWS/AgentRegistry e verifique regras do EventBridge que usam a origem aws.bedrock-agentcore, que passa a aws.agent-registry.
Ajuste a confiança do IAM antes de carregar registros sincronizados
Há uma etapa específica para registros sincronizados com credenciais de função IAM: antes da carga efetiva, a política de confiança da função precisa aceitar agent-registry.amazonaws.com. A AWS informa que a ferramenta de migração não detecta essa dependência. O requisito não se aplica a registros autenticados por OAuth nem aos que não usam autorização.
Se um registro migrado entrar em CREATE_FAILED, a recuperação indicada pela AWS é corrigir a política de confiança, excluir o novo registro com falha e executar a carga novamente. Faça essa checagem antes de carregar ao vivo os registros afetados.
Valide os dados e os acessos no novo namespace
Depois da carga, compare a quantidade de registries e de registros em cada registry, confira amostras dos registros transformados e teste leituras e gravações em agent-registry. Atualize e teste também as integrações e regras que dependem dos novos endpoints, permissões, clientes, esquemas ou eventos.
A mudança se limita ao AWS Agent Registry: Identity, Gateway, Runtime e Policy não são afetados por essa migração. O namespace antigo do Registry será desligado em 30 de outubro de 2026; nessa data, o acesso de leitura e gravação termina e os dados que ainda estiverem nele serão perdidos.
