AWS chiuderà il namespace bedrock-agentcore di AWS Agent Registry il 30 ottobre 2026. I dati esistenti non migrano automaticamente: i team devono trasferirli nel nuovo namespace agent-registry prima della scadenza, perché quelli rimasti nel vecchio namespace andranno persi e l’accesso in lettura e scrittura terminerà. La guida di migrazione AWS descrive tre percorsi e una serie di modifiche da pianificare oltre al trasferimento dei record.
Scegli il metodo di migrazione
AWS indica una migrazione locale o con CloudShell per un trasferimento completo, job gestiti con AWS Glue per le esecuzioni non presidiate o incrementali e una strategia active-active per i registry di produzione che continuano a ricevere scritture. La tabella riassume come funzionano i tre percorsi descritti da AWS.
| Metodo | Quando considerarlo | Caricamento e passaggio al nuovo namespace |
| Locale o AWS CloudShell | Per una migrazione completa eseguita una tantum | Lo strumento estrae i dati, li trasforma nel nuovo schema e li carica nei nuovi registry. Può essere eseguito da terminale o CloudShell senza distribuire infrastruttura. |
| Job gestiti con AWS Glue | Per esecuzioni non presidiate o per aggiornare i dati al momento del passaggio | AWS descrive job AWS Glue distribuiti tramite lo stack CDK fornito; dopo il caricamento completo iniziale, è possibile eseguire un caricamento incrementale al cutover. |
| Active-active | Per registry di produzione con scritture continue | Dopo la migrazione completa, l’applicazione scrive in entrambi i namespace; dopo la convalida, letture e scritture passano a agent-registry. |
In tutti e tre i casi, lo strumento AWS estrae, trasforma e carica registry e record in nuovi registry nello stesso account AWS e nella stessa Regione. La migrazione è avviata dal cliente: non basta creare il nuovo namespace e aspettare che i dati compaiano.
Aggiorna codice e integrazioni, non solo il namespace
Il cambio è incompatibile con lo schema API precedente. Se il codice crea o interpreta richieste e risposte di Registry, va aggiornato per il nuovo schema, che introduce i campi obbligatori name e recordType e riorganizza i descrittori. Tra gli altri cambiamenti, inlineContent diventa data, mentre schemaVersion e protocolVersion confluiscono in dataSchemaVersion.
Vanno inoltre rivisti endpoint, permessi IAM, principal di servizio, ARN, client SDK e comandi CLI. Cambiano anche il namespace di CloudWatch e la sorgente EventBridge: le regole che corrispondono alla vecchia sorgente o ai tipi di dettaglio modificati devono essere aggiornate.
| Componente | Vecchio valore | Nuovo valore o intervento |
| Namespace Registry | bedrock-agentcore | agent-registry |
| Endpoint dati | bedrock-agentcore.{region}.amazonaws.com | agent-registry.{region}.api.aws |
| Endpoint di controllo | bedrock-agentcore-control.{region}.amazonaws.com | agent-registry-control.{region}.api.aws |
| Comandi CLI | aws bedrock-agentcore | aws agent-registry |
| Client SDK | BedrockAgentCoreClient; BedrockAgentCoreControlClient | AgentRegistryClient; AgentRegistryControlClient |
| Namespace CloudWatch | AWS/BedrockAgentCore | AWS/AgentRegistry |
| Sorgente EventBridge | aws.bedrock-agentcore | aws.agent-registry; aggiornare le regole interessate |
Anche IAM richiede attenzione. Il prefisso delle azioni Registry passa da bedrock-agentcore:* a agent-registry:*, e il principal di servizio Registry da bedrock-agentcore.amazonaws.com a agent-registry.amazonaws.com. La policy gestita BedrockAgentCoreFullAccess non acquisisce automaticamente i permessi agent-registry:*: AWS indica AgentRegistryFullAccess per l’accesso a Registry.
Non sostituire però in blocco ogni riferimento al vecchio prefisso. Le risorse di workload identity e i credential provider OAuth continuano a usare bedrock-agentcore; i relativi permessi devono restare dove servono. AWS limita questo spostamento ad AWS Agent Registry: Identity, Gateway, Runtime e Policy non rientrano nella migrazione del namespace.
Controlla la trust policy per i record sincronizzati con IAM
Prima di caricare dati in tempo reale, verifica i record sincronizzati usando credenziali di un ruolo IAM: la trust policy del ruolo deve accettare agent-registry.amazonaws.com. AWS avverte che lo strumento di migrazione non rileva questa dipendenza. La condizione riguarda i record sincronizzati tramite ruolo IAM, non quelli autenticati via OAuth o privi di autorizzazione.
Se un record migrato finisce in CREATE_FAILED, la procedura indicata da AWS è aggiornare la trust policy, eliminare il nuovo record non riuscito e rilanciare il caricamento.
Convalida il passaggio prima della chiusura
Dopo la migrazione, AWS raccomanda di confrontare il numero di registry e di record per ciascun registry, controllare a campione i record trasformati, aggiornare le integrazioni e provare sia le letture sia le scritture nel nuovo namespace. La finestra di migrazione, aperta il 6 agosto 2026, si chiude il 30 ottobre 2026: da quella data il vecchio namespace Registry verrà disattivato, l’accesso in lettura e scrittura terminerà e i dati ancora presenti lì andranno persi. La guida introduttiva di AWS Agent Registry riporta la stessa scadenza.
