有关管理您的 CloudWatch Logs 资源的访问权限的概述 - Amazon CloudWatch Logs
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

有关管理您的 CloudWatch Logs 资源的访问权限的概述

EVERYAmazon资源归一个 Amazon Web Services 账户 ,创建或访问资源的权限由权限策略进行管理。账户管理员可以向 IAM 身份(即:用户、组和角色)附加权限策略,某些服务(如 Amazon Lambda)也支持向资源附加权限策略。

注意

网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的账户管理员(或管理员 IAM 用户)是具有管理员权限的用户。有关更多信息,请参阅 。IAM 最佳实践中的IAM 用户指南.

在授予权限时,您要决定谁获得权限,获得对哪些资源的权限,以及您允许对这些资源执行的具体操作。

CloudWatch Logs 资源和操作

在 CloudWatch Logs 中,主资源是日志组、日志流和目标。CloudWatch Logs 不支持子资源(与主资源一起使用的其他资源)。

这些资源和子资源具有与其关联的唯一 Amazon 资源名称 (ARN),如下表所示。

资源类型 ARN 格式

日志组

arn:aws:logs:region:account-id:log-group:log_group_name

日志流

arn:aws:logs:region:account-id:log-group:log_group_name:log-stream:log-stream-name

目的地

arn:aws:logs:region:account-id:destination:destination_name

有关 ARN 的更多信息,请参阅ARNIAM 用户指南. 有关 CloudWatch Logs ARN 的信息,请参阅Amazon 资源名称 (ARN)Amazon Web Services 一般参考. 有关包含 CloudWatch Logs 的策略的示例,请参阅为 CloudWatch Logs 使用基于身份的策略(IAM 策略).

CloudWatch Logs 提供了一组操作来处理 CloudWatch Logs 资源。有关可用操作的列表,请参阅 CloudWatch Logs 权限参考

了解资源所有权

Amazon 账户对在该账户下创建的资源具有所有权,而无论创建资源的人员是谁。具体而言,资源所有者是对资源创建请求进行身份验证的Amazon委托人实体 (即根账户、IAM 用户或 IAM 角色) 的 账户。以下示例说明了它的工作原理:

  • 如果您使用您的根账户凭证Amazon帐户创建日志组,则您的Amazon账户是 CloudWatch Logs 资源的所有者。

  • 如果您在Amazon帐户并向该用户授予创建 CloudWatch Logs 资源的权限,则该用户可以创建 CloudWatch 日志资源。但是,您的Amazon账户拥有 CloudWatch Logs 资源。

  • 如果您在Amazon账户,任何能够代入该角色的人都可以创建 CloudWatch 日志资源。您的Amazon账户拥有 CloudWatch Logs 资源。

管理对资源的访问

权限策略 规定谁可以访问哪些内容。下一节介绍创建权限策略时的可用选项。

注意

本节讨论如何在 CloudWatch Logs 范围内使用 IAM。这里不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档,请参阅什么是 IAM?中的IAM 用户指南. 有关 IAM 策略语法和说明的信息,请参阅IAM 策略参考中的IAM 用户指南.

附加到 IAM 身份的策略称作基于身份 的策略 (IAM 策略),附加到资源的策略称作基于资源 的资源。CloudWatch Logs 支持基于身份的策略和适用于目标的基于资源的策略,该策略用于启用跨账户订阅。有关更多信息,请参阅交叉-a计数lOGd阿塔s哈利用subscriptions

日志组权限和参与者见解

贡献者洞察是 CloudWatch 的一项功能,它使您能够分析来自日志组的数据并创建显示贡献者数据的时间序列。您可以查看有关前 N 个贡献者、独特贡献者总数及其使用情况的指标。有关更多信息,请参阅使用 Contributor Insights 分析高基数数据

当您向用户授予cloudwatch:PutInsightRulecloudwatch:GetInsightRuleReport权限,该用户可以创建一个规则来评估 CloudWatch 日志中的任何日志组,然后查看结果。结果可以包含这些日志组的贡献者数据。请务必仅将这些权限授予应该能够查看此数据的用户。

基于身份的策略(IAM 策略)

您可以向 IAM 身份附加策略。例如,您可以执行以下操作:

  • 将权限策略附加到账户中的用户或组— 要授予在 CloudWatch Logs 控制台中查看日志的用户权限,您可以将权限策略附加到用户或用户所属的组。

  • 将权限策略附加到角色(授予跨账户权限)— 您可以将基于身份的权限策略挂载到 IAM 角色,以授予跨账户的权限。例如,账户 A 中的管理员可以创建一个角色,以向其他 Amazon 账户(如账户 B)或某项 Amazon 服务授予跨账户权限,如下所述:

    1. 账户 A 管理员可以创建一个 IAM 角色,然后向该角色附加授予其访问账户 A 中资源的权限策略。

    2. 账户 A 管理员可以向将账户 B 标识为能够代入该角色的委托人的角色附加信任策略。

    3. 之后,账户 B 管理员可以委派权限,指定账户 B 中的任何用户担任该角色。这样,账户 B 中的用户就可以创建或访问账户 A 中的资源了。如果您需要授予 Amazon 服务权限来担任该角色,则信任策略中的委托人也可以是 Amazon 服务委托人。

    有关使用 IAM 委派权限的更多信息,请参阅访问控制中的IAM 用户指南.

以下示例策略授予对logs:PutLogEventslogs:CreateLogGroup, 和logs:CreateLogStream在 us-east-1 的所有资源操作。对于日志组,CloudWatch Logs 支持对某些 API 操作使用资源 ARN(也称为资源级权限)标识特定资源。如果您希望包含所有日志组,则必须指定通配符 (*)。

{ "Version":"2012-10-17", "Statement":[ { "Sid":"", "Effect":"Allow", "Action":[ "logs:PutLogEvents", "logs:CreateLogGroup", "logs:CreateLogStream" ], "Resource":"arn:aws:logs:us-east-1:*:*" } ] }

有关将基于身份的策略用于 CloudWatch Logs 的更多信息,请参阅。为 CloudWatch Logs 使用基于身份的策略(IAM 策略). 有关用户、组、角色和权限的更多信息,请参阅《IAM 用户指南》中的身份(用户、组和角色)

基于资源的策略

CloudWatch Logs 支持适用于目标的基于资源的策略,您可以使用该策略启用跨账户订阅。有关更多信息,请参阅创建destination。可使用 PutDestination API 创建目标,您可使用 PutDestination API 向目标添加资源策略。下面的示例允许另一个Amazon账户 ID 为 111122223333,将其日志组订阅到目标arn:aws:logs:us-east-1:123456789012:destination:testDestination.

{ "Version" : "2012-10-17", "Statement" : [ { "Sid" : "", "Effect" : "Allow", "Principal" : { "AWS" : "111122223333" }, "Action" : "logs:PutSubscriptionFilter", "Resource" : "arn:aws:logs:us-east-1:123456789012:destination:testDestination" } ] }

指定策略元素:操作、效果和委托人

对于每个 CloudWatch Logs 资源,该服务都定义了一组 API 操作。为授予这些 API 操作的权限,CloudWatch Logs 定义了一组您可以在策略中指定的操作。某些 API 操作可能需要多个操作的权限才能执行 API 操作。有关资源和 API 操作的更多信息,请参阅 CloudWatch Logs 资源和操作CloudWatch Logs 权限参考

以下是基本的策略元素:

  • 资源 – 您使用 Amazon 资源名称 (ARN) 来标识策略应用到的资源。有关更多信息,请参阅CloudWatch Logs 资源和操作

  • 操作 – 您可以使用操作关键字标识要允许或拒绝的资源操作。例如,logs.DescribeLogGroups 权限允许执行 DescribeLogGroups 操作的用户权限。

  • Effect— 用于指定用户请求特定操作时的效果(可以是允许或拒绝)。如果没有显式授予(允许)对资源的访问权限,则隐式拒绝访问。您也可显式拒绝对资源的访问,这样可确保用户无法访问该资源,即使有其他策略授予了访问权限的情况下也是如此。

  • 委托人 – 在基于身份的策略(IAM 策略)中,附加了策略的用户是隐式委托人。对于基于资源的策略,您可以指定要接收权限的用户、账户、服务或其他实体 (仅适用于基于资源的策略)。CloudWatch Logs 支持适用于目标的基于资源的策略。

要详细了解 IAM 策略语法和说明,请参阅AmazonIAM 策略参考中的IAM 用户指南.

有关显示所有 CloudWatch Logs API 操作及其适用的资源的表,请参阅。CloudWatch Logs 权限参考.

在策略中指定条件

当您授予权限时,可使用访问策略语言来指定规定策略何时生效的条件。例如,您可能希望策略仅在特定日期后应用。有关使用策略语言指定条件的更多信息,请参阅《IAM 用户指南》中的条件

要表示条件,您可以使用预定义的条件键。有关每个支持的上下文键的列表Amazon服务和Amazon范围内的策略密钥,请参阅的操作、资源和条件键Amazon服务Amazon全局条件上下文键.

注意

CloudWatch Logs 不支持 IAM 策略,这些策略阻止用户使用aws:Resource/key-name或者aws:TagKeys条件键。此外,您无法控制对DescribeLogGroups操作,通过使用aws:ResourceTag/key-name条件键。其他 CloudWatch Logs 操作支持使用aws:ResourceTag/key-name条件键来控制访问。有关使用标签控制访问的更多信息,请参阅使用标签控制对 Amazon Web Services 资源的访问.