使用 CodeCatalyst 的服务相关角色
Amazon CodeCatalyst 使用 AWS Identity and Access Management（IAM）服务相关角色。服务相关角色是一种独特类型的 IAM 角色，它与 CodeCatalyst 直接相关。服务相关角色由 CodeCatalyst 预定义，并包含服务代表您调用其它 AWS 服务所需的所有权限。
服务相关角色可让您更轻松地设置 CodeCatalyst，因为您不必手动添加必要的权限。CodeCatalyst 定义其服务相关角色的权限，除非另外定义，否则只有 CodeCatalyst 可以代入其角色。定义的权限包括信任策略和权限策略，以及不能附加到任何其他 IAM 实体的权限策略。
只有在首先删除相关资源后，您才能删除服务相关角色。这可以保护您的 CodeCatalyst 资源，因为您不会无意中删除对资源的访问权限。
有关支持服务相关角色的其他服务的信息，请参阅与 IAM 配合使用的 AWS 服务，并查找服务相关角色列中显示为是的服务。选择是和链接，查看该服务的服务相关角色文档。
CodeCatalyst 的服务相关角色权限
CodeCatalyst 使用名为 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 的服务相关角色 – 使 Amazon CodeCatalyst 能够代表您对应用程序实例配置文件及相关目录用户和组进行只读访问。
AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 服务相关角色信任以下服务代入该角色：
-
codecatalyst.amazonaws.com
名为 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronizationPolicy 的角色权限策略使 CodeCatalyst 能够对指定资源完成以下操作：
-
操作：
CodeCatalyst spaces that support identity federation and SSO users and groups的View application instance profiles and associated directory users and groups
您必须配置使用户、组或角色能够创建、编辑或删除服务相关角色的权限。有关更多信息，请参阅《IAM 用户指南》中的服务相关角色权限。
创建 CodeCatalyst 的服务相关角色
您无需手动创建服务相关角色。当您在 AWS Management Console、AWS CLI 或 AWS API 中创建空间时，CodeCatalyst 会为您创建服务相关角色。
重要
如果您在其他使用此角色支持的功能的服务中完成某个操作，此服务相关角色可以出现在您的账户中。此外，如果您在 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 Management Console、AWS CLI 或 AWS API 中删除空间时，CodeCatalyst 会为您清理资源并删除服务相关角色。
还可以使用 IAM 控制台、AWS CLI 或 AWS API 手动删除服务相关角色。为此，必须先手动清除服务相关角色的资源，然后才能手动删除。
注意
如果在您试图删除资源时 CodeCatalyst 服务正在使用该角色，则删除操作可能会失败。如果发生这种情况，请等待几分钟后重试。
删除 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 所用的 CodeCatalyst 资源
-
删除空间。
使用 IAM 手动删除服务相关角色
使用 IAM 控制台，即 AWS CLI 或 AWS API 来删除 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 服务相关角色。有关更多信息，请参阅《IAM 用户指南》中的删除服务相关角色。
CodeCatalyst 服务相关角色的受支持区域
CodeCatalyst 支持在提供该服务的所有区域中使用服务相关角色。有关更多信息，请参阅 AWS 区域和端点。
CodeCatalyst 不支持在提供该服务的每个区域中使用服务相关角色。您可以在以下区域中使用 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 角色。
| 区域名称 | 区域标识 | 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 | 否 |
| Asia Pacific (Osaka) | ap-northeast-3 | 否 |
| Asia Pacific (Seoul) | 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 | 否 |
| South America（São Paulo） | sa-east-1 | 否 |
| AWS GovCloud（美国东部） | us-gov-east-1 | 否 |
| AWS GovCloud（美国西部） | us-gov-west-1 | 否 |
