终止支持通知：2026 年 10 月 7 日， AWS 将终止对的支持。 AWS Proton 2026 年 10 月 7 日之后，您将无法再访问 AWS Proton 控制台或 AWS Proton 资源。您部署的基础架构将保持不变。有关更多信息，请参阅《[AWS Proton 服务弃用和迁移指南》](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)。

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

# 使用角色进行 CodeBuild基于基础的资源调配
<a name="using-service-linked-roles-codebuild"></a>

AWS Proton 使用 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 角色的独特类型。 AWS Proton服务相关角色由服务预定义 AWS Proton ，包括该服务代表您调用其他 AWS 服务所需的所有权限。

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

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

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

## 的服务相关角色权限 AWS Proton
<a name="service-linked-role-permissions-codebuild"></a>

AWS Proton 使用名为 “服务关联角色” **AWSServiceRoleForProtonCodeBuildProvisioning**的服务相关角色进行 AWS Proton CodeBuild 置备。

**AWSServiceRoleForProtonCodeBuildProvisioning** 服务相关角色信任以下服务代入该角色：
+ `codebuild.proton.amazonaws.com`

名为的角色权限策略`AWSProtonCodeBuildProvisioningServiceRolePolicy` AWS Proton 允许对指定资源完成以下操作：
+ 操作：针对 *CloudFormation 堆栈和转换*的*创建、管理和读取*
+ 操作：*创建、管理和阅读CodeBuild **项目和构建*

有关此策略的更多信息，请参阅“[AWS 托管策略： AWSProtonCodeBuildProvisioningServiceRolePolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSProtonCodeBuildProvisioningServiceRolePolicy)”。

您必须配置权限，允许 IAM 实体（如用户、组或角色）创建、编辑或删除服务关联角色。有关更多信息，请参阅*《IAM 用户指南》*中的[服务关联角色权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 为创建服务相关角色 AWS Proton
<a name="create-service-linked-role-codebuild"></a>

您无需手动创建服务关联角色。当您在 AWS 管理控制台、或 AWS API AWS Proton 中创建使用 CodeBuild基于服务的配置的 AWS CLI环境时， AWS Proton 会为您创建服务相关角色。

如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您在中创建使用 CodeBuild基于服务的配置的环境时 AWS Proton， AWS Proton 会再次为您创建服务相关角色。

## 编辑的服务相关角色 AWS Proton
<a name="edit-service-linked-role-codebuild"></a>

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

## 删除的服务相关角色 AWS Proton
<a name="delete-service-linked-role-codebuild"></a>

如果不再需要使用某个需要服务关联角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，您必须 AWS Proton 先删除中使用 CodeBuild基于配置的所有环境和服务（实例和管道），然后才能手动将其删除。

### 手动删除服务相关角色
<a name="slr-manual-delete-codebuild"></a>

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

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

AWS Proton 支持在所有提供服务 AWS 区域 的地方使用与服务相关的角色。有关更多信息，请参阅 *AWS 一般参考* 中的 [AWS Proton 端点和配额](https://docs.aws.amazon.com/general/latest/gr/proton.html)。