AWS Agent Registry旧入口10月30日关闭:哪些权限要改,哪些要保留?

同一份配置里的bedrock-agentcore并不都要替换。本文解释Registry迁移截止的影响,列出四类IAM字段及逐项验收方法。

Registry迁移字段分类示意:Registry动作和资源转向agent-registry;Identity取令牌权限保留bedrock-agentcore;IAM同步角色信任改新服务,而调用方PassRole条件保留Identity服务。
本站原创教学示意。字段按用途分别核对;不代表完整IAM策略、产品界面或已完成迁移。

先说结论

AWS文档给出的Registry旧命名空间迁移截止日是2026年10月30日,届时未迁移用户将失去旧Registry服务及其中剩余数据的读写访问。迁移只涉及Registry;Registry动作与资源转用agent-registry,Identity相关权限仍保留bedrock-agentcore。数据不会自动迁移,修改服务名后仍须验收数据、IAM同步和真实应用请求。

读完你会得到

  • 先确认是否仍使用旧Registry,再按字段所属服务决定修改范围。
  • 同步角色的信任策略和调用方的PassRole条件属于不同权限路径。
  • 保留源数据与新旧ID映射,迁移报告通过后继续检查实际应用。
  • 截止日期未给出具体时区或切换时刻,不能据此安排最后一分钟迁移。

如果团队仍通过bedrock-agentcore命名空间管理或搜索AWS Agent Registry,这次截止会影响现有集成。先找出正在使用的Registry入口,再看下面的字段对照。只使用AgentCore Runtime或Identity的团队,不应把这次迁移当作整个AgentCore停服。

先确认影响范围:关闭的是旧Registry入口

AWS迁移文档把2026年10月30日列为旧bedrock-agentcore Registry命名空间的关闭日,届时失去旧服务及剩余数据的读写访问。这个通知没有说明物理删除,也没有给出具体时区或切换时刻。

新agent-registry命名空间已于2026年8月6日推出。本文在2026年10月28日核验临近截止的迁移要求;原文未标首次发布日期,因此没有把8月的推出写成今天的新发布。Identity、Gateway、Runtime和Policy不在这次命名空间迁移范围内。

本节依据: [1] AWS Documentation

同一个旧字符串,在四种字段里的处理不同

先标清字段属于谁,再决定怎么改。下表只列最容易混淆的项目,不能作为可直接部署的完整IAM策略。

官方字段对照;实际资源范围仍需逐项限制
字段用途迁移处理应核对的位置
Registry API动作与Registry资源转用agent-registry动作及Registry ARN调用方权限策略;例如CreateRegistryRecord及目标Registry ARN。搜索动作须对照新API名,不能只替换前缀。
Identity取令牌与OAuth提供方保留bedrock-agentcoreGetWorkloadAccessToken、GetResourceOauth2Token及对应Identity资源;OAuth提供方限定为实际所需ARN。
使用IAM凭证同步的角色信任Principal.Service改为agent-registry.amazonaws.com受影响同步角色的信任策略,决定谁能承担该角色。
调用方传递同步角色的条件iam:PassedToService保留bedrock-agentcore.amazonaws.com调用方iam:PassRole策略;这里指向AgentCore Identity,作用不同于上一行。

检查时把“角色信任策略”和“调用方权限策略”分别展开。即使两处都出现Service字样,它们也不是同一字段。不能把一处的修改结果复制到另一处,更不能据某个请求成功推断另一条权限路径也通过。

Registry生命周期还涉及Identity权限。官方权限页列出的CreateWorkloadIdentity、GetWorkloadIdentity和DeleteWorkloadIdentity仍使用bedrock-agentcore。清理旧权限前,应确认删掉的到底是旧Registry动作,还是新Registry仍需要的Identity动作。

本节依据: [1] AWS Documentation [2] AWS Documentation [3] AWS Documentation

先做一张字段变更账,避免“替换完成”掩盖漏项

本站建议先收集实际使用的账户、区域、Registry标识、客户端版本、调用入口、记录同步方式和配置负责人。只读取必要的资源配置,不把令牌值或密钥放入迁移表。

每一行记录一个具体配置位置,例如某应用的SDK客户端、某条IAM Statement或某个同步角色。不要把“所有权限已修改”当作一行已完成记录。

可直接在自己的工单中填写;以下是字段说明,没有提供独立下载文件
记录字段填写内容
配置位置与归属应用/基础设施文件的定位,所属Registry、Identity或IAM角色,以及负责人。
当前值与目标值保留原值、计划值、依据链接;无需修改的字段也写明保留原因。
实际资源源Registry/record标识、目标实际标识、账户、区域及对应角色。
验收请求与结果由哪个执行身份调用哪个API,预期结果、实际时间、状态及脱敏证据。
未完成条件仍有旧写入、同步失败、映射缺失或未知权限;谁负责处理,何时重查。

官方迁移工具提供新旧record ID对照及逐记录比较报告。把真实目标标识回填到应用配置,不能用修改旧ARN前缀代替核对。

客户端、请求和响应结构也要一起检查。迁移工具负责数据处理,应用自己构造和解析的JSON仍需要适配。建议为一个已有记录保存脱敏输入及预期业务输出,迁移后用相同业务问题比较,避免仅检查HTTP状态。

本节依据: [4] AWS Labs / agentcore-samples

数据迁移与应用切换分开安排

数据不会自动搬到新命名空间。下面的顺序是本站安排建议,实际工具命令、权限和环境要求应按官方仓库执行。不要把教学顺序当作已完成迁移的证明。

  1. 先确认旧端还有没有写入

    查清发布流水线、定时同步和人工维护入口。可以停写的,记录停写点;必须持续写入的,明确增量或双写方案、失败补偿及负责人才开始。

    产出:源资源清单、旧写入入口、切换期间的数据归属。
  2. 选择迁移方式,保留可复核的输入

    官方工具区分一次性完整迁移与支持无人值守、增量加载的Glue方式。先核对目标配置和试运行报告。未提供目标Registry ID时,init会创建目标,初始化流程不能一概当作只读检查。首次live加载前,先更新使用IAM凭证同步的受影响角色信任;check和dry-run不能证明这条异步角色路径可用。

    产出:拟执行工具版本、源到目标映射、试运行报告;敏感配置另存。
  3. 分别核对记录和权限

    比对每个Registry的记录数与状态,再抽查实际描述内容、同步配置和应用依赖的标识。按上一节账本检查两条权限路径。记录存在不等于同步已完成。

    产出:逐项比较结果、失败记录及实际请求证据。
  4. 收齐最后增量,再切换消费者

    明确最终增量覆盖到何时,处理停写或双写期间的差异,然后让应用从新入口读写。安排一个不影响业务的受控写入验证,确认后清理该测试记录,并观察旧入口是否仍有调用。

    产出:最终数据核对、应用切换时间、未解决项与故障联系人。

本节依据: [1] AWS Documentation [4] AWS Labs / agentcore-samples

用六个演练检查“看起来迁好了”的情况

以下为本站设计的假设演练,未执行,表中只有预期判断,没有实测通过率。请在隔离测试资源上安排,不直接向生产目录注入故障。

演练要留下请求身份、资源、时间与结果;敏感值脱敏
设置或观察应该怎样判断下一步证据
记录数一致,但业务客户端仍指向源Registry不能完成切换验收从该客户端取得实际请求入口及目标Registry标识;确认读取新资源。
全局替换后Identity取令牌失败先检查被误改的Identity动作与资源与变更前配置对照,恢复官方要求保留的字段,再重测真实取令牌路径。
新记录创建完成,IAM同步随后失败创建响应不证明异步同步成功读取该记录实际状态与原因,核对它引用的同步角色信任。
角色信任已改,调用方PassRole条件也照抄为新服务两条策略被混成一条处理分别核对信任Principal.Service和调用方iam:PassedToService,并检查各自实际请求。
最终迁移后旧端又增加一条记录最后增量的时间边界不完整查这条变更是否进入目标,补齐差异后再确认切换。
读请求成功,受控写入被拒绝只通过了读路径检查实际写入身份、动作及资源范围;不要用追加管理员权限代替定位。

遇到失败时,先区分策略错误、记录状态与应用配置

官方给出一种需要额外恢复步骤的情况:IAM同步角色仍信任旧服务,使新记录进入CREATE_FAILED。只修正信任策略不够,迁移工具不会覆盖失败状态的记录;应按官方步骤删除新命名空间内那条受影响的CREATE_FAILED记录,再重跑加载。

执行这类删除前,本站建议先保存失败原因、源记录和新旧映射,确认目标命名空间及记录ID。这个步骤仅针对上述异常,不适用于清空目录,也不要求删除源记录。若状态或原因不同,按实际错误排查,不套用删除重建。

准备一份能交给下一位工程师的故障记录

  • 确认到底是哪次操作失败

    保存实际API名、执行身份、账户/区域、目标标识、时间及请求ID;同步任务补充异步状态与原因。

  • 把失败定位到具体配置行

    区分调用方动作授权、传角色条件、被传角色的信任及应用仍引用旧资源。对照变更账,避免同时修改所有策略。

  • 保留已成功项与待处理项

    用真实记录标识管理差异;未知原因标为未解决。失败修复后重测相应路径,再判断是否能够继续切换。

本节依据: [1] AWS Documentation [4] AWS Labs / agentcore-samples

今天可以先做什么

先挑一个仍使用旧Registry的实际应用,把客户端入口、目标Registry、同步角色和调用方策略放在同一张变更账里。用四类字段对照完成分类,再安排受控验证。对于没有旧Registry资源的团队,保留此类“按字段归属迁移”的方法即可,无需因为截止提醒改动其他AgentCore服务。

AI随心创的企业AI / FDE服务涉及任务诊断、系统集成与交付。需要讨论这类迁移时,可以准备脱敏的资源关系、配置差异、调用链及尚未解决的失败记录,用于界定诊断和验收范围;文章演练不代表我们已在客户环境完成这次迁移。

继续阅读:运行时发现端点后怎样绑定凭证,适合检查迁移后的实际调用边界;MCP接入鉴权验收,用于补齐应用身份与业务授权检查。团队分工可参考企业AI与FDE实施导航。

服务沟通:企业AI / FDE服务。事实核对与更正方式见编辑与来源政策。

常见问题

这次通知意味着整个AgentCore都要停用吗?

不意味着。迁移通知针对Registry的旧bedrock-agentcore命名空间,不能扩大为Identity、Gateway、Runtime或Policy停服。先确认自己是否仍有旧Registry集成。

可以只替换IAM里的服务名前缀吗?

不可以。Registry和Identity的字段需要分类,IAM同步角色信任与调用方PassRole条件也不同;还必须检查数据迁移、应用结构及实际请求。

10月30日具体几点关闭?

2026年10月28日核验的官方迁移页没有给出具体时区或时刻。不要自行换算为北京时间零点,也不要把旧入口当作截止后的回滚保证。

资料来源与核对说明

文章中的行业定义与技术方法尽量引用官方或标准组织资料;表格、清单和决策框架是基于这些资料形成的编辑性整理,不代表来源机构对本站服务的背书。

  1. Comprehensive registry migration guideAWS Documentation

    2026-10-28核验。原页未标首次发布日期;新命名空间推出日为2026-08-06,旧Registry迁移窗口截止为2026-10-30,未给具体时区/时刻。核对关闭后的旧服务及剩余数据读写访问、非整个AgentCore迁移、数据不自动迁移、IAM同步角色信任及特定CREATE_FAILED恢复。没有推断物理删除或实际账户迁移结果。

  2. IAM PermissionsAWS Documentation

    2026-10-28核验,原页未标发布日期。核对新Registry动作与ARN、搜索动作改名、Registry生命周期仍依赖bedrock-agentcore的Identity动作;本文不提供完整部署策略,也未实测账户权限。

  3. Synchronize records from external sourcesAWS Documentation

    2026-10-28核验,原页未标发布日期。核对OAuth取令牌动作及资源仍属Identity,调用方iam:PassedToService=bedrock-agentcore.amazonaws.com保持;这是PassRole条件,与同步角色信任Principal.Service用途不同。

  4. AWS Agent Registry — migrate your data to the new version of RegistryAWS Labs / agentcore-samples

    2026-10-28核验main分支README,未把抓取时间或提交时间当发布日期。核对工具区分数据迁移与代码适配、init会创建目标、一次性与Glue增量方式、ID对照与逐记录比较报告。本文未执行工具,默认按官方迁移指南的同账户/区域范围安排,不推断跨账户已获验证。

把文章方法用于你的真实业务

带上流程、样例和目标,添加企业微信沟通。先确定项目范围与验收方式,再安排实施。

查看企业 AI / FDE 服务 →
相机、麦克风和布光台上的雕塑,表现图片、视频与声音的创作
AI 生成 · 内容创作场景示意

把你正在做的事,
拿来一起聊聊。

还没有完整方案也没关系。选一个方向,带着下面几条信息联系团队,我们先了解问题,再确认下一步。

企业 AI / FDE 项目

先从一段具体流程说起。

  • 我们目前怎样完成这项工作?
  • 哪一步最费时间,或经常出错?
  • 已有的资料、系统和期望结果是什么?
Shopify 建站与经营

有店铺的话,可以一并发来链接。

  • 店铺是准备上线,还是已经在运营?
  • 销售什么商品,面向哪些市场?
  • 希望先解决哪个页面或经营问题?
内容创作与工具使用

说明准备制作的内容,或遇到的操作问题。

  • 想做图片、视频、配音,还是图文?
  • 已有素材、参考风格和使用场景是什么?
  • 如果使用时遇到问题,具体停在哪一步?
扫码添加随心创技术客服企业微信

微信扫码,发来你的问题

可以直接按提纲描述,也可以先发一句话。人工服务会在确认范围后单独报价。

手机上可保存二维码后识别。