使用角色在 CloudTrail 中创建和管理 CloudTrail 事件上下文 - Amazon CloudTrail
CloudTrail 的服务相关角色权限为 CloudTrail 创建服务相关角色编辑 CloudTrail 的服务相关角色为 CloudTrail 删除 AWSServiceRoleForCloudTrailEventContext 服务相关角色
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用角色在 CloudTrail 中创建和管理 CloudTrail 事件上下文

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

服务相关角色可让您更轻松地设置 CloudTrail，因为您不必手动添加必要的权限。CloudTrail 定义其服务相关角色的权限，除非另外定义，否则只有 CloudTrail 可以代入该角色。定义的权限包括信任策略和权限策略，以及不能附加到任何其他 IAM 实体的权限策略。

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

有关支持服务相关角色的其他服务的信息，请参阅使用 IAM 的 Amazon 服务，并查找服务相关角色列中显示为是的服务。选择是和链接，查看该服务的服务相关角色文档。

CloudTrail 的服务相关角色权限

CloudTrail 使用名为 AWSServiceRoleForCloudTrailEventContext 的服务相关角色 – 此服务相关角色用于管理 CloudTrail 事件上下文和 EventBridge 规则。

AWSServiceRoleForCloudTrailEventContext 服务相关角色信任以下服务代入该角色：

  • context.cloudtrail.amazonaws.com

名为 CloudTrailEventContext 的角色权限策略允许 CloudTrail 对指定的资源完成以下操作：

  • 针对资源标签的操作：

    • tag:GetResources

  • 针对 CloudTrail 服务主体的所有 Amazon EventBridge 资源的操作，用于创建规则：

    • events:PutRule

  • 针对 CloudTrail 服务主体的所有 Amazon EventBridge 资源的操作，用于管理其创建的规则：

    • events:PutTargets

    • events:DeleteRule

    • events:RemoveTargets

    • events:RemoveTargets

  • 针对 CloudTrail 服务主体的所有 Amazon EventBridge 资源的操作，用于描述其创建的规则：

    • events:DescribeRule

    • events:DeRegisterResource

  • 针对所有 Amazon EventBridge 资源的操作：

    • events:ListRules

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

有关与 AWSServiceRoleForCloudTrailEventContext 关联的托管式策略的更多信息，请参阅 Amazon适用于 的 托管式策略Amazon CloudTrail。

为 CloudTrail 创建服务相关角色

您无需手动创建服务相关角色。当您开始使用 Amazon Web Services 管理控制台、Amazon CLI 或 Amazon API 中的上下文事件功能时，CloudTrail 会为您创建服务相关角色。

如果您删除该服务相关角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您开始使用上下文事件功能时，CloudTrail 会再次为您创建服务相关角色。

编辑 CloudTrail 的服务相关角色

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

为 CloudTrail 删除 AWSServiceRoleForCloudTrailEventContext 服务相关角色

如果不再需要使用某个需要 AWSServiceRoleForCloudTrailEventContext 服务相关角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，您必须清理服务相关角色的资源，然后才能通过从事件数据存储中移除 TagContext 键来手动删除它。

注意

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

删除 AWSServiceRoleForCloudTrailEventContext 服务相关角色使用的 CloudTrail 资源

  1. 在终端或命令行中，对要从中移除 TagContext 键的事件存储运行 put-event-configuration 命令。例如，要从 ARN 为 arn:aws:cloudtrail:us-east-2:111122223333:eventdatastore/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 的美国东部（俄亥俄州）区域中账户 111122223333 的事件存储中移除 TagContext 键（其中 TagContext 是唯一上下文键选择器），您可以使用 put-event-configuration 命令，但不要为 --context-key-selectors 指定任何值：

     aws cloudtrail put-event-configuration --event-data-store arn:aws:cloudtrail:us-east-2:111122223333:eventdatastore/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 --max-event-size Large --context-key-selectors

  2. 对分区中每个区域的每个数据存储重复此命令。有关更多信息，请参阅使用 Amazon 资源名称 (ARN) 标识 Amazon 资源。

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

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