本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 将服务相关角色用于 EventBridge
Amazon EventBridge 使用 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 角色的独特类型。 EventBridge服务相关角色由服务预定义 EventBridge ，包括该服务代表您调用其他 AWS 服务所需的所有权限。
服务相关角色使设置变得 EventBridge 更加容易，因为您不必手动添加必要的权限。 EventBridge 定义其服务相关角色的权限，除非另有定义，否则 EventBridge 只能担任其角色。定义的权限包括信任策略和权限策略，以及不能附加到任何其他 IAM 实体的权限策略。
只有在首先删除相关资源后，您才能删除服务关联角色。这样可以保护您的 EventBridge 资源，因为您不会无意中删除访问资源的权限。
有关支持服务相关角色的其他服务的信息，请参阅与 [IAM 配合使用的AWS 服务，](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)并在**服务相关角色**列中查找标有 “**是**” 的服务。选择**是**和链接，查看该服务的服务关联角色文档。
# 使用角色为中的 API 目标创建密钥 EventBridge
以下主题详细介绍了****AWSServiceRoleForAmazonEventBridgeApiDestinations****服务相关角色的用法。
## 的服务相关角色权限 EventBridge
EventBridge 使用名为的服务相关角色 ****AWSServiceRoleForAmazonEventBridgeApiDestinations****— 允许访问由 EventBridge创建的 Secrets Manager 密钥。
**AWSServiceRoleForAmazonEventBridgeApiDestinations** 服务相关角色信任以下服务代入该角色：
+ `apidestinations.events.amazonaws.com`
名为的角色权限策略**AmazonEventBridgeApiDestinationsServiceRolePolicy** EventBridge 允许对指定资源完成以下操作：
+ 操作：`secrets created for all connections by EventBridge` 上的 `create, describe, update and delete secrets; get and put secret values`
您必须配置使用户、组或角色能够创建、编辑或删除服务相关角色的权限。有关更多信息，请参阅*《IAM 用户指南》*中的[服务相关角色权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。
## 为创建服务相关角色 EventBridge
您无需手动创建服务关联角色。当您在 AWS 管理控制台、或 AWS API 中创建连接时， EventBridge 会为您创建服务相关角色。 AWS CLI
**重要**
如果您在其他使用此角色支持的功能的服务中完成某个操作，此服务关联角色可以出现在您的账户中。如果您在 2021 年 2 月 11 日 EventBridge 服务开始支持服务相关角色之前使用该服务，则在您的账户中 EventBridge 创建了该**AWSServiceRoleForAmazonEventBridgeApiDestinations**角色。要了解更多信息，请参阅 “[我的” 中出现了一个新角色 AWS 账户](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared)。
如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。创建连接时， EventBridge 会再次为您创建服务相关角色。
## 编辑的服务相关角色 EventBridge
EventBridge 不允许您编辑**AWSServiceRoleForAmazonEventBridgeApiDestinations**服务相关角色。创建服务关联角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息，请参阅《IAM 用户指南》**中的[编辑服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。
## 删除的服务相关角色 EventBridge
如果不再需要使用某个需要服务关联角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，您必须先清除您的服务相关角色，然后才能手动删除它。
### 清除服务相关角色
必须先删除服务相关角色使用的所有资源，然后才能使用 IAM 删除该角色。
**注意**
如果您尝试删除资源时 EventBridge 服务正在使用该角色，则删除可能会失败。如果发生这种情况，请等待几分钟后重试。
**删除 **AWSServiceRoleForAmazonEventBridgeApiDestinations**（控制台）使用的 EventBridge 资源**
1. 打开 Amazon EventBridge 控制台，网址为[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)。
1. 在**集成**下，选择 **API 目标**，然后选择**连接**选项卡。
1. 选择相应的连接，然后选择**删除**。
**删除 **AWSServiceRoleForAmazonEventBridgeApiDestinations**(AWS CLI) 使用的 EventBridge 资源**
+ 使用以下命令：`[delete-connection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/delete-connection.html)`。
**删除 **AWSServiceRoleForAmazonEventBridgeApiDestinations**(API) 使用的 EventBridge 资源**
+ 使用以下命令：`[DeleteConnection](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DeleteConnection.html)`。
### 手动删除服务相关角色
使用 IAM 控制台 AWS CLI、或 AWS API 删除**AWSServiceRoleForAmazonEventBridgeApiDestinations**服务相关角色。有关更多信息，请参阅《IAM 用户指南》**中的[删除服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。
## EventBridge 服务相关角色支持的区域
EventBridge 支持在提供服务的所有区域中使用服务相关角色。有关更多信息，请参阅[AWS 区域和端点](https://docs.aws.amazon.com/general/latest/gr/rande.html)。
# 在 Amazon 中使用角色进行架构发现 EventBridge
以下主题详细介绍了****AWSServiceRoleForSchemas****服务相关角色的用法。
## 的服务相关角色权限 EventBridge
EventBridge 使用名为的服务相关角色 ****AWSServiceRoleForSchemas****— 向 Amazon EventBridge 架构创建的托管规则授予权限。
**AWSServiceRoleForSchemas** 服务相关角色信任以下服务代入该角色：
+ `schemas.amazonaws.com`
名为的角色权限策略****AmazonEventBridgeSchemasServiceRolePolicy**** EventBridge 允许对指定资源完成以下操作：
+ 操作：`all managed rules created by EventBridge` 上的 `put, enable, disable, and delete rules; put and remove targets; list targets per rule`
您必须配置使用户、组或角色能够创建、编辑或删除服务相关角色的权限。有关更多信息，请参阅*《IAM 用户指南》*中的[服务相关角色权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。
## 为创建服务相关角色 EventBridge
您无需手动创建服务关联角色。当您在 AWS 管理控制台、或 AWS API 中进行架构发现时， EventBridge 会为您创建服务相关角色。 AWS CLI
**重要**
如果您在其他使用此角色支持的功能的服务中完成某个操作，此服务关联角色可以出现在您的账户中。如果您在 2019 年 11 月 27 日 EventBridge 服务开始支持服务相关角色之前使用该服务，则在您的账户中 EventBridge 创建了该**AWSServiceRoleForSchemas**角色。要了解更多信息，请参阅 “[我的” 中出现了一个新角色 AWS 账户](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared)。
如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您进行架构发现时， EventBridge 会再次为您创建服务相关角色。
## 编辑的服务相关角色 EventBridge
EventBridge 不允许您编辑**AWSServiceRoleForSchemas**服务相关角色。创建服务关联角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息，请参阅《IAM 用户指南》**中的[编辑服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。
## 删除的服务相关角色 EventBridge
如果不再需要使用某个需要服务关联角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，您必须先清除您的服务相关角色，然后才能手动删除它。
### 清除服务相关角色
必须先删除服务相关角色使用的所有资源，然后才能使用 IAM 删除该角色。
**注意**
如果您尝试删除资源时 EventBridge 服务正在使用该角色，则删除可能会失败。如果发生这种情况，请等待几分钟后重试。
**删除 **AWSServiceRoleForSchemas**（控制台）使用的 EventBridge 资源**
1. 打开 Amazon EventBridge 控制台，网址为[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)。
1. 在**总线**下，选择**事件总线**，然后选择一个事件总线。
1. 选择**停止发现**。
**删除 **AWSServiceRoleForSchemas**(AWS CLI) 使用的 EventBridge 资源**
+ 使用以下命令：`[delete-discoverer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/delete-discoverer.html)`。
**删除 **AWSServiceRoleForSchemas**(API) 使用的 EventBridge 资源**
+ 使用以下命令：`[DeleteDiscoverer](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers-id-discovererid.html#DeleteDiscoverer)`。
### 手动删除服务相关角色
使用 IAM 控制台 AWS CLI、或 AWS API 删除**AWSServiceRoleForSchemas**服务相关角色。有关更多信息，请参阅《IAM 用户指南》**中的[删除服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。
## EventBridge 服务相关角色支持的区域
EventBridge 支持在提供服务的所有区域中使用服务相关角色。有关更多信息，请参阅 [AWS 区域和端点](https://docs.aws.amazon.com/general/latest/gr/rande.html)。