使用角色为 API 目标创建密钥 - Amazon EventBridge
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

使用角色为 API 目标创建密钥

Amazon EventBridge 使用 Amazon Identity and Access Management(IAM)服务相关角色。服务相关角色是一种独特类型的 IAM 角色,它与 EventBridge 直接相关。服务相关角色由 EventBridge 预定义,并包含该服务代表您调用其他 Amazon 服务所需的一切权限。

服务相关角色使 EventBridge 的设置更轻松,因为您不必手动添加必要的权限。EventBridge 定义其服务相关角色的权限,除非另行定义,否则仅 EventBridge 可以担任其角色。定义的权限包括信任策略和权限策略,以及不能附加到任何其他 IAM 实体的权限策略。

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

有关支持服务相关角色的其他服务的信息,请参阅与 IAM 配合使用的 Amazon 服务,并查找 Service-linked roles(服务相关角色)列中显示为 Yes(是)的服务。请选择与查看该服务的服务相关角色文档的链接。

EventBridge 的服务相关角色权限

EventBridge使用名为的服务相关角色 AWSServiceRoleForAmazonEventBridgeApiDestinations— 允许访问由EventBridge创建的 Secrets Manager 密钥。

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

  • apidestinations.events.amazonaws.com

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

  • 操作:secrets created for all connections by EventBridge 上的 create, describe, update and delete secrets; get and put secret values

您必须配置允许用户、组或角色创建、编辑或删除服务相关角色的权限。有关更多信息,请参阅《IAM 用户指南》中的服务相关角色权限

为 EventBridge 创建服务相关角色

您无需手动创建服务相关角色。当您在Amazon Web Services Management Console、或 Amazon API 中创建连接时,EventBridge会为您创建服务相关角色。Amazon CLI

重要

如果您在其他使用此角色支持的功能的服务中完成某个操作,此服务相关角色可以出现在您的账户中。如果您在 2021 年 2 月 11 日EventBridge服务开始支持服务相关角色之前使用该服务,则在您的账户中EventBridge创建了该AWSServiceRoleForAmazonEventBridgeApiDestinations角色。要了解更多信息,请参阅我的 Amazon Web Services 账户中出现新角色

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

为 EventBridge 编辑服务相关角色

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

删除 EventBridge 的服务相关角色

如果不再需要使用某个需要服务相关角色的特征或服务,建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是,您必须先清除您的服务相关角色,然后才能手动删除它。

清除服务相关角色

必须先删除服务相关角色使用的所有资源,然后才能使用 IAM 删除该角色。

注意

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

删除 AWSServiceRoleForAmazonEventBridgeApiDestinations 所用的 EventBridge 资源(控制台)
  1. 打开亚马逊 EventBridge 控制台,网址为 https://console.aws.amazon.com/events/

  2. 在 “集成” 下选择 “API 目的地”,然后选择 “连接” 选项卡。

  3. 选择连接,然后选择删除

删除 AWSServiceRoleForAmazonEventBridgeApiDestinations 所用的 EventBridge 资源 (Amazon CLI)
删除 AWSServiceRoleForAmazonEventBridgeApiDestinations 所用的 EventBridge 资源 (API)

手动删除服务相关角色

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

EventBridge 服务相关角色的受支持区域

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