View a markdown version of this page

将服务相关角色用于 CodeCatalyst - Amazon CodeCatalyst

CodeCatalyst Amazon 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息,请参阅 如何从中迁移 CodeCatalyst

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

将服务相关角色用于 CodeCatalyst

亚马逊 CodeCatalyst 使用 AWS Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种与之直接关联的 IAM 角色的独特类型。 CodeCatalyst Service-linked 角色由预定义 CodeCatalyst ,包括该服务代表您调用其他AWS服务所需的所有权限。

服务相关角色使设置变得 CodeCatalyst 更加容易,因为您不必手动添加必要的权限。 CodeCatalyst 定义其服务相关角色的权限,除非另有定义,否则 CodeCatalyst 只能担任其角色。定义的权限包括信任策略和权限策略,以及不能附加到任何其他 IAM 实体的权限策略。

只有在首先删除相关资源后,您才能删除服务关联角色。这样可以保护您的 CodeCatalyst 资源,因为您不会无意中删除访问资源的权限。

有关支持服务相关角色的其他服务的信息,请参阅与 IAM 配合使用的AWS服务,并在Service-linked 角色列中查找带有 “” 的服务。请选择与查看该服务的服务关联角色文档的链接。

Service-linked 的角色权限 CodeCatalyst

CodeCatalyst 使用名为的服务相关角色 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization— 允许 Amazon 代表您对应用程序实例配置文件以及关联的目录用户和群组进行 CodeCatalyst 只读访问。

AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 服务相关角色信任以下服务代入该角色:

  • codecatalyst.amazonaws.com

名为的角色权限策略AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronizationPolicy CodeCatalyst 允许对指定资源完成以下操作:

  • 操作:CodeCatalyst spaces that support identity federation and SSO users and groupsView application instance profiles and associated directory users and groups

您必须配置使用户、组或角色能够创建、编辑或删除服务相关角色的权限。有关更多信息,请参阅 IAM 用户指南中的Service-linked 角色权限

为创建服务相关角色 CodeCatalyst

您无需手动创建服务关联角色。当您在AWS 管理控制台、或 AWS API 中创建空间时, CodeCatalyst 会为您创建服务相关角色。AWS CLI

重要

如果您在其他使用此角色支持的功能的服务中完成某个操作,此服务关联角色可以出现在您的账户中。另外,如果您在 2023 年 11 月 17 日该 CodeCatalyst 服务开始支持服务相关角色之前使用该服务,则在您的账户中 CodeCatalyst 创建了该AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization角色。要了解更多信息,请参阅 “我的” 中出现了一个新角色AWS 账户

如果您删除该服务关联角色,然后需要再次创建,您可以使用相同流程在账户中重新创建此角色。创建空间时, CodeCatalyst 会再次为您创建服务相关角色。

您也可以使用 IAM 控制台,在查看应用程序实例配置文件及相关目录用户和组使用案例中创建服务相关角色。在AWS CLI或 AWS API 中,使用服务名称创建服务相关角色。codecatalyst.amazonaws.com有关更多信息,请参阅 IAM 用户指南 中的创建服务相关角色。如果您删除了此服务相关角色,可以使用同样的过程再次创建角色。

编辑的服务相关角色 CodeCatalyst

CodeCatalyst 不允许您编辑AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization服务相关角色。创建服务关联角色后,您将无法更改角色的名称,因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息,请参阅《IAM 用户指南》中的编辑服务关联角色

删除的服务相关角色 CodeCatalyst

无需手动删除 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 角色。当您删除AWS 管理控制台、或 AWS API 中的空格时,会 CodeCatalyst 清理资源并为您删除服务相关角色。AWS CLI

您也可以使用 IAM 控制台、AWS CLI或 AWS API 手动删除服务相关角色。为此,必须先手动清除服务相关角色的资源,然后才能手动删除。

注意

如果您尝试删除资源时 CodeCatalyst 服务正在使用该角色,则删除可能会失败。如果发生这种情况,请等待几分钟后重试。

要删除使用的 CodeCatalyst 资源 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization

使用 IAM 手动删除服务关联角色

使用 IAM 控制台AWS CLI、或 AWS API 删除AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization服务相关角色。有关更多信息,请参阅《IAM 用户指南》中的删除服务关联角色

CodeCatalyst 服务相关角色支持的区域

CodeCatalyst 支持在提供服务的所有区域中使用服务相关角色。有关更多信息,请参阅AWS区域和端点

CodeCatalyst 不支持在提供服务的每个区域中使用服务相关角色。您可以在以下区域中使用 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 角色。

区域名称 区域标识 Support in CodeCatalyst
美国东部(弗吉尼亚州北部) us-east-1
美国东部(俄亥俄州) us-east-2
美国西部(北加利福尼亚) us-west-1
美国西部(俄勒冈州) us-west-2
非洲(开普敦) af-south-1
亚太地区(香港) ap-east-1
亚太地区(雅加达) ap-southeast-3
亚太地区(孟买) ap-south-1
亚太地区(大阪) ap-northeast-3
亚太地区(首尔) ap-northeast-2
亚太地区(新加坡) ap-southeast-1
亚太地区(悉尼) ap-southeast-2
亚太地区(东京) ap-northeast-1
加拿大(中部) ca-central-1
欧洲地区(法兰克福) eu-central-1
欧洲地区(爱尔兰) eu-west-1
欧洲地区(伦敦) eu-west-2
欧洲地区(米兰) eu-south-1
欧洲地区(巴黎) eu-west-3
欧洲地区(斯德哥尔摩) eu-north-1
中东(巴林) me-south-1
中东(阿联酋): me-central-1
南美洲(圣保罗) sa-east-1
AWS GovCloud (US-East) us-gov-east-1
AWSGovCloud (US-West) us-gov-west-1