亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

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

# 将服务相关角色用于 CodeCatalyst
<a name="using-service-linked-roles"></a>

亚马逊 CodeCatalyst 使用 AWS Identity and Access Management (IAM) [服务相关角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)。服务相关角色是一种与之直接关联的 IAM 角色的独特类型。 CodeCatalyst服务相关角色由服务预定义 CodeCatalyst ，包括该服务代表您调用其他 AWS 服务所需的所有权限。

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

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

有关支持服务相关角色的其他服务的信息，请参阅与 [IAM 配合使用的AWS 服务，](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)并在**服务相关角色**列中查找标有 “**是**” 的服务。选择**是**和链接，查看该服务的服务关联角色文档。

## 的服务相关角色权限 CodeCatalyst
<a name="slr-permissions"></a>

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 用户指南》*中的[服务相关角色权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 为创建服务相关角色 CodeCatalyst
<a name="create-slr"></a>

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

**重要**  
如果您在其他使用此角色支持的功能的服务中完成某个操作，此服务关联角色可以出现在您的账户中。另外，如果您在 2023 年 11 月 17 日该 CodeCatalyst 服务开始支持服务相关角色之前使用该服务，则在您的账户中 CodeCatalyst 创建了该AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization角色。要了解更多信息，请参阅 “[我的” 中出现了一个新角色 AWS 账户](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared)。

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

您也可以使用 IAM 控制台，在**查看应用程序实例配置文件及相关目录用户和组**使用案例中创建服务相关角色。在 AWS CLI 或 AWS API 中，使用服务名称创建服务相关角色。`codecatalyst.amazonaws.com`有关更多信息，请参阅 *IAM 用户指南* 中的[创建服务相关角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role)。如果您删除了此服务相关角色，可以使用同样的过程再次创建角色。

## 编辑的服务相关角色 CodeCatalyst
<a name="edit-slr"></a>

CodeCatalyst 不允许您编辑AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization服务相关角色。创建服务关联角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息，请参阅《IAM 用户指南》**中的[编辑服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

## 删除的服务相关角色 CodeCatalyst
<a name="delete-slr"></a>

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

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

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

**要删除使用的 CodeCatalyst 资源 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization**
+ [删除空间](https://docs.aws.amazon.com/codecatalyst/latest/userguide/spaces-delete.htm)。

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

使用 IAM 控制台 AWS CLI、或 AWS API 删除AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization服务相关角色。有关更多信息，请参阅《IAM 用户指南》**中的[删除服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。

## CodeCatalyst 服务相关角色支持的区域
<a name="slr-regions"></a>

CodeCatalyst 支持在提供服务的所有区域中使用服务相关角色。有关更多信息，请参阅[AWS 区域和端点](https://docs.aws.amazon.com/general/latest/gr/rande.html)。

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-gov-east-1 | 否 | 
| AWS GovCloud （美国西部） | us-gov-west-1 | 否 |