为 CloudWatch Logs 使用服务相关角色 - Amazon CloudWatch Logs
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

为 CloudWatch Logs 使用服务相关角色

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

您可以使用服务相关角色轻松设置 CloudWatch Logs,因为您不必手动添加所需的权限。CloudWatch Logs 定义其服务相关角色的权限,除非另外定义,否则只有 CloudWatch Logs 可以代入该角色。定义的权限包括信任策略和权限策略。这些权限策略不能附加到任何其他 IAM 实体。

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

CloudWatch Logs 的服务相关角色权限

CloudWatch Logs 使用名为 AWSServiceRoleForLogDelivery 的服务相关角色。CloudWatch Logs 使用此服务相关角色将日志直接写入 Kinesis Data Firehose。有关更多信息,请参阅启用特定Amazon服务的日志记录

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

  • logs.amazonaws.com

角色权限策略允许 CloudWatch Logs 对指定资源完成以下操作:

  • 操作:所有 Kinesis Data Firehose 流上标记有 LogDeliveryEnabled 键且值为 Truefirehose:PutRecordfirehose:PutRecordBatch。当您创建订阅以将日志传送到 Kinesis Data Firehose 时,此标记会自动附加到 Kinesis Data Firehose 流。

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

为 CloudWatch Logs 创建服务相关角色

您无需手动创建服务相关角色。当您将日志设置为直接发送到 Amazon Web Services Management Console、Amazon CLI 或 Amazon API 中的 Kinesis Data Firehose 流时,CloudWatch Logs 将为您创建服务相关角色。

如果删除此服务相关角色,然后需要再次创建,可以使用相同流程在账户中重新创建此角色。当您再次将日志设置为直接发送到 Kinesis Data Firehose 流时,CloudWatch Logs 将再次为您创建服务相关角色。

为 CloudWatch Logs 编辑服务相关角色

创建角色后,CloudWatch Logs 不允许您编辑 AWSServiceRoleForLogDelivery 或任何其他与服务相关的角色。由于多个实体可能引用该角色,因此无法更改角色的名称。但是可以使用 IAM 编辑角色说明。有关更多信息,请参见 IAM 用户指南中的编辑服务相关角色

为 CloudWatch Logs 删除服务相关角色

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

注意

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

删除 AWSServiceRoleForLogDelivery 服务相关角色所使用的 CloudWatch Logs 资源
  • 停止将日志直接发送到 Kinesis Data Firehose 流。

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

使用 IAM 控制台、Amazon CLI 或 Amazon API 来删除 AWSServiceRoleForLogDelivery 服务相关角色。有关更多信息,请参阅删除服务相关角色

CloudWatch Logs 服务相关角色支持的区域

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