文档中心

AgentKit

请输入

管理凭据

更换角色

更换角色用于调整火山云角色凭据所使用的 IAM 角色。更换完成后，系统将基于新角色换取 STS 临时凭证，后续请求也将按照新角色的权限访问火山引擎云资源。

如果新角色未授予业务所需权限，可能导致 TOS、方舟或相关工具调用失败。操作前，请确认新角色已配置正确的信任关系和权限策略。了解更多

使用限制

是否支持直接更换角色，取决于凭据当前采用的角色配置方式：

配置方式	是否支持直接更换	说明
默认角色	支持	凭据使用固定角色，可通过更换角色直接替换。
规则匹配	不支持	角色由身份 Claim 和匹配规则决定，请通过编辑凭据调整匹配规则及对应角色。
调用方指定	不支持	角色由调用方在白名单范围内指定，请通过编辑凭据调整角色白名单。
混合模式	不支持	角色由调用方指定或规则匹配结果决定，请通过编辑凭据角色白名单、匹配规则或默认角色。

适用场景

前提条件

已完成目标 IAM 角色创建。

操作步骤

最近更新时间：2026.10.12 17:21:40

这个页面对您有帮助吗？

有用

无用