View a markdown version of this page

记录数据事件 - Amazon CloudTrail
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

记录数据事件

本节介绍如何使用记录数据事件 CloudTrail 控制台 和 Amazon CLI。

默认情况下,跟踪和事件数据存储不记录数据事件。记录数据事件将收取额外费用。有关更多信息,请参阅Amazon CloudTrail 定价。

数据事件提供有关对在资源上或资源内执行的资源操作的信息。这些也称为数据层面操作。数据事件通常是高容量活动。

示例数据事件包括:

您可以使用高级事件选择器来创建细粒度选择器,通过仅为您的使用场景记录感兴趣的特定事件来帮助控制成本。例如,您可以通过在 eventName 字段上添加筛选条件,使用高级事件选择器来记录特定 API 调用。有关更多信息,请参阅 使用高级事件选择器筛选数据事件。

注意

您的跟踪记录的事件可在亚马逊上找到 EventBridge。例如,如果您选择记录 S3 对象的数据事件而非管理事件,则您的跟踪将仅处理和记录指定 S3 对象的数据事件。这些 S3 对象的数据事件在 Amazon 中可用 EventBridge。有关更多信息,请参阅 Amazon 通过以下方式交付的服务事件 CloudTrail 在 亚马逊 EventBridge 用户指南 还有 Amazon 活动参考。

目录

数据事件

下表显示可用于跟踪的资源类型。资源类型(控制台)列显示控制台中的相应选择。这个 resources.type 值 列显示了 resources.type 要指定该值以便在跟踪中包含该类型的数据事件,请使用 Amazon CLI 要么 CloudTrail API。

对于跟踪,您可以使用基本或高级事件选择器来记录通用存储桶、Lambda 函数和 DynamoDB 表中的 Amazon S3 对象的数据事件(显示在表的前三行中)。您只能使用高级事件选择器来记录其余行中显示的资源类型。

支持的数据事件 Amazon CloudTrail

Amazon Web Services 服务 说明 资源类型(控制台) resources.type 值

Amazon AppConfig

Amazon AppConfig 用于配置操作的 API 活动,例如调用 StartConfigurationSession 和 GetLatestConfiguration。有关更多信息,请参阅 Amazon AppConfig。

Amazon AppConfig

AWS::AppConfig::Configuration

Amazon AppSync

Amazon AppSync API 活动已开启 AppSync GraphQL API。有关更多信息,请参阅 Amazon AppSync。

AppSync GraphQL

AWS::AppSync::GraphQLApi

Amazon Bedrock

亚马逊 Bedrock apiKey CredentialProvider API 活动。

Bedrock-AgentCore apiKey CredentialProvider

AWS::BedrockAgentCore::APIKeyCredentialProvider

Amazon Bedrock

Amazon Bedrock 浏览器 API 活动。

Bedrock-AgentCore 浏览器

AWS::BedrockAgentCore::Browser

Amazon Bedrock

亚马逊基岩 Browser-Custom API 活动。

Bedrock-AgentCore Browser-Custom

AWS::BedrockAgentCore::BrowserCustom

Bedrock-AgentCore 浏览器配置文件

API 活动已开启 AWS::BedrockAgentCore::BrowserProfile 资源。

Bedrock-AgentCore 浏览器配置文件

AWS::BedrockAgentCore::BrowserProfile

Amazon Bedrock

亚马逊基岩 Code-Interpreter API 活动。

Bedrock-AgentCore Code-Interpreter

AWS::BedrockAgentCore::CodeInterpreter

Amazon Bedrock

亚马逊基岩 Code-Interpreter-Custom API 活动。

Bedrock-AgentCore Code-Interpreter-Custom

AWS::BedrockAgentCore::CodeInterpreterCustom

Amazon Bedrock

Amazon Bedrock 网关 API 活动。

Bedrock-AgentCore 网关

AWS::BedrockAgentCore::Gateway

Amazon Bedrock

亚马逊 Bedrock Oauth2 CredentialProvider API 活动。

Bedrock-AgentCore Oauth2 CredentialProvider

AWS::BedrockAgentCore::OAuth2CredentialProvider

Amazon Bedrock

Amazon Bedrock 运行时 API 活动。

Bedrock-AgentCore 运行时

AWS::BedrockAgentCore::Runtime

Amazon Bedrock

亚马逊基岩 Runtime-Endpoint API 活动。

Bedrock-AgentCore Runtime-Endpoint

AWS::BedrockAgentCore::RuntimeEndpoint

Amazon Bedrock

Amazon Bedrock 令牌文件库 API 活动。

Bedrock-AgentCore 代币库

AWS::BedrockAgentCore::TokenVault

Amazon Bedrock

Amazon Bedrock 工作负载身份 API 活动。

Bedrock-AgentCore 工作负载身份

AWS::BedrockAgentCore::WorkloadIdentity

Amazon Bedrock

Amazon Bedrock 工作负载身份目录 API 活动。

Bedrock-AgentCore 工作负载身份目录

AWS::BedrockAgentCore::WorkloadIdentityDirectory

Amazon Keyspaces(Apache Cassandra 兼容)

对 Cassandra CDC 流的 Amazon Keyspaces(Apache Cassandra 兼容)API 活动。

Cassandra CDC 流

AWS::Cassandra::Stream

Amazon Keyspaces(Apache Cassandra 兼容)

表上的 Amazon Keyspaces API 活动。有关更多信息,请参阅 亚马逊密钥空间(适用于 Apache Cassandra)。

Cassandra 表

AWS::Cassandra::Table

Certificate Manager

API 活动已开启 AWS::CertificateManager::AcmeEndpoint 资源。

Amazon::CertificateManager::AcmeEndpoint

AWS::CertificateManager::AcmeEndpoint

亚马逊 CloudWatch

亚马逊 CloudWatch 指标上的 API 活动。有关更多信息,请参阅 亚马逊 CloudWatch。

CloudWatch 指标

AWS::CloudWatch::Metric

Amazon Cognito

针对 Amazon Cognito 身份池的 Amazon Cognito API 活动。有关更多信息,请参阅 亚马逊 Cognito。

Cognito 身份池

AWS::Cognito::IdentityPool

Amazon DynamoDB

针对流的 Amazon DynamoDB API 活动 有关更多信息,请参阅 亚马逊 DynamoDB。

DynamoDB Streams

AWS::DynamoDB::Stream

Amazon DynamoDB

Amazon DynamoDB 表格上的商品级 API 活动(例如, PutItem, DeleteItem,以及 UpdateItem API 操作)。对于启用了流的表,数据事件中的资源字段包含两者 Amazon:: dynamoDB:: Stream 和 Amazon:: dynamoDB:: 表。如果你指定 Amazon::dynamoDB:: Table for resources.type,默认情况下,它将同时记录 DynamoDB 表和 DynamoDB 流事件。要排除直播事件,请在 eventName 字段上添加过滤器。有关更多信息,请参阅 亚马逊 DynamoDB。

DynamoDB

AWS::DynamoDB::Table

Amazon Elastic Block Store

亚马逊弹性区块存储 (EBS) 直接 API,例如 PutSnapshotBlock, GetSnapshotBlock,以及 ListChangedBlocks 在亚马逊 EBS 快照上。欲了解更多信息,请参阅 亚马逊弹性区块商店。

EBS 直接 API

AWS::EC2::Snapshot

Amazon Elastic Container Service

对容器实例的 Amazon Elastic Container Service API 活动。

ECS 容器实例

AWS::ECS::ContainerInstance

Amazon Elastic Kubernetes Service

对控制面板的 Amazon Elastic Kubernetes Service API 活动。

EKS 控制板

AWS::EKS::Dashboard

EventBridge endpoint

API 活动已开启 AWS::Events::Endpoint 资源。

EventBridge 终端节点

AWS::Events::Endpoint

EventBridge 自定义事件总线-经典

API 活动已开启 AWS::Events::EventBus 资源。

EventBridge 自定义事件总线-经典

AWS::Events::EventBus

EventBridge 合作伙伴事件来源

API 活动已开启 AWS::Events::EventSource 资源。

EventBridge 合作伙伴事件来源

AWS::Events::EventSource

EventBridge 规则

API 活动已开启 AWS::Events::Rule 资源。

EventBridge 规则

AWS::Events::Rule

Amazon FSx

针对卷的 Amazon FSx API 活动。

fsX 音量

AWS::FSx::Volume

Amazon 物联网绿草版本 2

组件版本上来自 Greengrass 核心设备的 Greengrass API 活动。Greengrass 不会记录访问被拒绝事件。欲了解更多信息,请参阅 Amazon 物联网绿草版本 2。

IoT Greengrass 组件版本

AWS::GreengrassV2::ComponentVersion

Amazon 物联网绿草版本 2

部署上来自 Greengrass 核心设备的 Greengrass API 活动。Greengrass 不会记录访问被拒绝事件。欲了解更多信息,请参阅 Amazon 物联网绿草版本 2。

IoT Greengrass 部署

AWS::GreengrassV2::Deployment

亚马逊 GuardDuty

GuardDuty 恶意软件扫描的 API 活动。

GuardDuty 恶意软件扫描

AWS::GuardDuty::MalwareScan

Amazon 物联网

Amazon 有关证书的 IoT API 活动。欲了解更多信息,请参阅 Amazon 物联网。

IoT 证书

AWS::IoT::Certificate

Amazon 物联网

Amazon 物联网 API 在事物上的活动。欲了解更多信息,请参阅 Amazon 物联网。

IoT 事物

AWS::IoT::Thing

Amazon 物联网隧道

API 活动已开启 AWS::IoT::Tunnel 资源。

Amazon 物联网隧道

AWS::IoT::Tunnel

Amazon 物联网 SiteWise

物联网 SiteWise 资产上的 API 活动。欲了解更多信息,请参阅 Amazon 物联网 SiteWise。

物联网 SiteWise 资产

AWS::IoTSiteWise::Asset

Amazon 物联网 SiteWise

物联网 SiteWise 时间序列上的 API 活动。欲了解更多信息,请参阅 Amazon 物联网 SiteWise。

物联网 SiteWise 时间序列

AWS::IoTSiteWise::TimeSeries

Amazon 物联网 TwinMaker

物联网 TwinMaker 实体上的 API 活动。欲了解更多信息,请参阅 Amazon 物联网 TwinMaker。

物联网 TwinMaker 实体

AWS::IoTTwinMaker::Entity

Amazon 物联网 TwinMaker

物联网 TwinMaker 工作空间上的 API 活动。欲了解更多信息,请参阅 Amazon 物联网 TwinMaker。

物联网 TwinMaker 工作区

AWS::IoTTwinMaker::Workspace

Amazon Kinesis Data Streams

流上的 Kinesis Data Streams API 活动。有关更多信息,请参阅 亚马逊 Kinesis 数据流。

Kinesis 流

AWS::Kinesis::Stream

Amazon Kinesis Data Streams

流使用者的上的 Kinesis Data Streams API 活动。有关更多信息,请参阅 亚马逊 Kinesis 数据流。

Kinesis 流使用者

AWS::Kinesis::StreamConsumer

Amazon Data Firehose

Amazon Data Firehose 传输流 API 活动。

Amazon Data Firehose

AWS::KinesisFirehose::DeliveryStream

Amazon 兰姆达

Amazon Lambda 函数执行活动(调用 API)。

Lambda

AWS::Lambda::Function

Lambda 微型虚拟机镜像

API 活动已开启 AWS::Lambda::MicrovmImage 资源。

Lambda 微型虚拟机镜像

AWS::Lambda::MicrovmImage

Amazon Managed Workflows for Apache Airflow

对环境的 Amazon MWAA API 活动。

托管 Apache Airflow

AWS::MWAA::Environment

Amazon Redshift

Redshift 集群上的 API 活动。

Redshift 集群

AWS::Redshift::Cluster

Amazon S3

接入点上的 Amazon S3 API 活动。有关更多信息,请参阅 Amazon S3。

S3 接入点

AWS::S3::AccessPoint

Amazon S3

Amazon S3 对象级 API 活动(例如, GetObject, DeleteObject,以及 PutObject 对通用存储桶中的对象进行 API 操作)。有关更多信息,请参阅 Amazon S3。

S3

AWS::S3::Object

S3 快速接入点

API 活动已开启 AWS::S3Express::AccessPoint 资源。

S3 快速接入点

AWS::S3Express::AccessPoint

Amazon S3

Amazon S3 对象级 API 活动(例如, GetObject, DeleteObject,以及 PutObject 对目录存储桶中的对象进行 API 操作)。有关更多信息,请参阅 Amazon S3。

S3 Express

AWS::S3Express::Object

Amazon S3

亚马逊 S3 对象 Lambda 接入点 API 活动,例如调用 CompleteMultipartUpload 和 GetObject。有关更多信息,请参阅 Amazon S3。

S3 对象 Lambda

AWS::S3ObjectLambda::AccessPoint

Amazon S3 表类数据存储服务

针对表的 Amazon S3 API 活动。有关更多信息,请参阅 亚马逊 S3 表。

S3 表

AWS::S3Tables::Table

Amazon S3 表类数据存储服务

针对表存储桶的 Amazon S3 API 活动。有关更多信息,请参阅 亚马逊 S3 表。

S3 表存储桶

AWS::S3Tables::TableBucket

Amazon S3 Vectors

针对向量索引的 Amazon S3 API 活动。有关更多信息,请参阅 亚马逊 S3 矢量图。

S3 向量索引

AWS::S3Vectors::Index

Amazon S3 Vectors

针对向量存储桶的 Amazon S3 API 活动。有关更多信息,请参阅 亚马逊 S3 矢量图。

S3 向量存储桶

AWS::S3Vectors::VectorBucket

亚马逊 SageMaker AI

亚马逊 SageMaker AI InvokeEndpointWithResponseStream 端点上的活动。欲了解更多信息,请参阅 亚马逊 SageMaker AI。

SageMaker 终端节点

AWS::SageMaker::Endpoint

亚马逊 SageMaker AI

亚马逊 SageMaker 功能商店上的 AI API 活动。

SageMaker 功能商店

AWS::SageMaker::FeatureGroup

Amazon 云端地图

Amazon 命名空间上的 Cloud Map API 活动。有关更多信息,请参阅 Amazon 云端地图。

Amazon 云地图命名空间

AWS::ServiceDiscovery::Namespace

Amazon 云端地图

Amazon 服务上的 Cloud Map API 活动。有关更多信息,请参阅 Amazon 云端地图。

Amazon 云地图服务

AWS::ServiceDiscovery::Service

Amazon SNS

亚马逊 SNS 在平台终端节点上发布 API 操作。有关更多信息,请参阅 Amazon SNS。

SNS 平台端点

AWS::SNS::PlatformEndpoint

Amazon SNS

亚马逊 SNS 发布和 PublishBatch 关于主题的 API 操作。有关更多信息,请参阅 Amazon SNS。

SNS 主题

AWS::SNS::Topic

Amazon SQS

消息上的 Amazon SQS API 活动。有关更多信息,请参阅 Amazon SQS。

SQS

AWS::SQS::Queue

Amazon 系统经理

托管节点上的 Systems Manager API 活动。有关更多信息,请参阅 Amazon 系统经理。

Systems Manager 托管式节点

AWS::SSM::ManagedNode

Amazon 系统经理

控制通道上的 Systems Manager API 活动。有关更多信息,请参阅 Amazon 系统经理。

Systems Manager (系统管理员)

AWS::SSMMessages::ControlChannel

Amazon 步进函数

对活动的 Step Functions API 活动。有关更多信息,请参阅 Amazon 步进函数。

Step Functions 活动

AWS::StepFunctions::Activity

Amazon 步进函数

对状态机的 Step Functions API 活动。有关更多信息,请参阅 Amazon 步进函数。

Step Functions 状态机

AWS::StepFunctions::StateMachine

Amazon SWF

域上的 Amazon SWF API 活动。欲了解更多信息,请参阅 亚马逊 SWF。

SWF 域

AWS::SWF::Domain

UXC 账户自定义

API 活动已开启 AWS::UXC::AccountCustomization 资源。

UXC 账户自定义

AWS::UXC::AccountCustomization

Amazon Verified Permissions

针对策略存储的 Amazon Verified Permissions API 活动。

Amazon Verified Permissions

AWS::VerifiedPermissions::PolicyStore

Amazon X-Ray

X-Ray 有关跟踪的 API 活动。有关更多信息,请参阅 Amazon X-Ray。

X-Ray 跟踪

AWS::XRay::Trace

要录制 CloudTrail 数据事件,必须明确添加要收集活动的每种资源类型。有关更多信息,请参阅使用 CloudTrail 控制台创建跟踪和为创建事件数据存储 CloudTrail 控制台活动。

在单区域跟踪或事件数据存储上,您只能为可在该区域中访问的资源记录数据事件。尽管 S3 存储桶是全球性的, Amazon Lambda 函数和 DynamoDB 表是区域性的。

记录数据事件将收取额外费用。对于 CloudTrail 定价,请参阅 Amazon CloudTrail 定价。

示例:记录 Amazon S3 对象的数据事件

记录一个 S3 存储桶中的所有 S3 对象的数据事件

下面的示例演示在为一个名为 amzn-s3-demo-bucket 的 S3 桶中的所有数据事件配置日志记录时日志记录是如何工作的。在这个例子中, CloudTrail 用户指定了空前缀,并提供了记录两者的选项 阅读 和 写作 数据事件。

  1. 用户将对象上传到 amzn-s3-demo-bucket。

  2. PutObject API 操作是 Amazon S3 对象级别的 API。它被记录为数据事件 CloudTrail。因为 CloudTrail 用户指定了一个带有空前缀的 S3 存储桶,将记录在该存储桶中任何对象上发生的事件。跟踪或事件数据存储将处理和记录事件。

  3. 另一个用户将对象上传到 amzn-s3-demo-bucket2。

  4. PutObject API 操作发生在不是为跟踪或事件数据存储指定的 S3 存储桶中的某个对象上。跟踪或事件数据存储不会记录事件。

记录特定 S3 对象的数据事件

下面的示例演示在为特定 S3 对象配置跟踪或事件数据存储以记录事件时日志记录的工作方式。在这个例子中, CloudTrail 用户指定了一个名为 S3 存储桶 amzn-s3-demo-bucket3,带前缀 my-images,以及仅登录的选项 写作 数据事件。

  1. 一个用户在存储桶中检测到一个以 my-images 前缀开头的对象,例如 arn:aws:s3:::amzn-s3-demo-bucket3/my-images/example.jpg。

  2. DeleteObject API 操作是 Amazon S3 对象级别的 API。它被记录为 写作 中的数据事件 CloudTrail。事件发生在与跟踪或事件数据存储中指定的 S3 存储桶和前缀匹配的对象上。跟踪或事件数据存储将处理和记录事件。

  3. 另一个用户删除了 S3 存储桶中一个带不同前缀的对象,例如 arn:aws:s3:::amzn-s3-demo-bucket3/my-videos/example.avi。

  4. 事件发生在与跟踪或事件数据存储中指定的前缀不匹配的对象上。跟踪或事件数据存储不会记录事件。

  5. 一个用户对对象 arn:aws:s3:::amzn-s3-demo-bucket3/my-images/example.jpg 调用 GetObject API 操作。

  6. 虽然事件发生在跟踪或事件数据存储中指定的存储桶和前缀上,但 GetObject 是读取类型的 Amazon S3 对象级别 API。它被记录为 阅读 中的数据事件 CloudTrail,并且跟踪或事件数据存储未配置为记录 阅读 事件。跟踪或事件数据存储不会记录事件。

注意

对于跟踪,如果记录特定 Amazon S3 存储桶的数据事件,建议不要使用将记录其数据事件的 Amazon S3 存储桶来接收在数据事件部分为跟踪指定的日志文件。使用相同的 Amazon S3 存储桶会导致您的跟踪在日志文件每次传输到 Amazon S3 存储桶时都记录数据事件。日志文件是按时间间隔传输的聚合事件,因此,事件与日志文件的比率不是 1:1;事件将记录到下一个日志文件中。例如,什么时候 CloudTrail 提供日志, PutObject 事件发生在 S3 存储桶上。如果还在数据事件部分中指定了 S3 存储桶,跟踪将处理 PutObject 事件并将其记录为数据事件。该操作是另一个 PutObject 事件,并且跟踪将重新处理和记录此事件。

如果您将跟踪配置为将所有 Amazon S3 数据事件记录在您的 Amazon S3 存储桶中,则可避免在接收日志文件的 Amazon S3 存储桶中记录数据事件 Amazon 账户,请考虑以下选项之一:

在其他对象中记录 S3 对象的数据事件 Amazon accounts

当您将跟踪配置为记录数据事件时,您还可以指定属于其他的 S3 对象 Amazon 账户。当事件在指定对象上发生时, CloudTrail 将评估事件是否与每个账户中的任何跟踪匹配。如果事件与某个跟踪设置匹配,则跟踪将处理并记录该账户的事件。通常,API 调用者和资源所有者都可以接收事件。

如果您拥有一个 S3 对象并且在跟踪中指定此对象,则您的跟踪将记录在您的账户中的对象上发生的事件。由于您拥有该对象,因此您的跟踪还将在其他账户调用该对象时记录事件。

如果您在跟踪中指定一个 S3 对象,并且其他账户拥有此对象,则您的跟踪仅记录在您的账户中的此对象上发生的事件。您的跟踪不会记录其他账户中发生的事件。

示例:记录两个 Amazon S3 对象的数据事件 Amazon accounts

以下示例显示了两个 Amazon 账户配置 CloudTrail 记录同一 S3 对象的事件。

  1. 在您的账户中,您希望您的跟踪记录名为 amzn-s3-demo-bucket 的 S3 存储桶中所有对象的数据事件。通过指定带空对象前缀的 S3 存储桶来配置跟踪。

  2. Bob 拥有一个单独的账户,该账户已获得对 S3 存储桶的访问权限。Bob 还希望记录同一 S3 存储桶中所有对象的数据事件。对于其跟踪,他配置了跟踪并指定带空对象前缀的同一 S3 存储桶。

  3. Bob 使用 PutObject API 操作将对象上传到 S3 存储桶。

  4. 此事件在他的账户中发生,并且与他的跟踪设置匹配。Bob 的跟踪将处理和记录该事件。

  5. 由于您拥有 S3 存储桶并且事件与您的跟踪设置匹配,因此您的跟踪也将处理和记录同一事件。因为现在有两个事件副本(一个记录在 Bob 的踪迹中,一个记录在你的踪迹中), CloudTrail 对数据事件的两份副本收费。

  6. 您将一个对象上传到 S3 存储桶。

  7. 此事件在您的账户中发生并且与您的跟踪设置匹配。您的跟踪将处理和记录此事件。

  8. 由于该事件不是在 Bob 的账户中发生的,而且他不拥有 S3 存储桶,因此 Bob 的跟踪不会记录该事件。 CloudTrail 仅对该数据事件的一份副本收费。

示例:记录所有存储桶的数据事件,包括两个存储桶使用的 S3 存储桶 Amazon accounts

以下示例显示了以下情况下的日志记录行为 选择您账户中的所有 S3 存储桶 已为在中收集数据事件的跟踪启用 Amazon 账户。

  1. 在您的账户中,您希望您的跟踪记录所有 S3 存储桶的数据事件。在 Data events(数据事件)中的 All current and future S3 buckets(所有当前和未来 S3 存储桶)下,您可以通过选择 Read(读取)事件、Write(写入)事件或同时选择两者,来配置跟踪。

  2. Bob 拥有一个单独的账户,该账户已被授予对您账户中 S3 存储桶的访问权限。他想记录他有权访问的存储桶的数据事件。他配置他的跟踪以获取所有 S3 存储桶的数据事件。

  3. Bob 使用 PutObject API 操作将对象上传到 S3 存储桶。

  4. 此事件在他的账户中发生,并且与他的跟踪设置匹配。Bob 的跟踪将处理和记录该事件。

  5. 由于您拥有 S3 存储桶并且事件与您跟踪的设置匹配,因此您的跟踪也将处理和记录此事件。因为现在有两个事件副本(一个记录在 Bob 的踪迹中,一个记录在你的踪迹中), CloudTrail 向每个账户收取数据事件副本的费用。

  6. 您将一个对象上传到 S3 存储桶。

  7. 此事件在您的账户中发生并且与您的跟踪设置匹配。您的跟踪将处理和记录此事件。

  8. 由于该事件不是在 Bob 的账户中发生的,而且他不拥有 S3 存储桶,因此 Bob 的跟踪不会记录该事件。 CloudTrail 仅对您账户中此数据事件的一份副本收费。

  9. 第三个用户 Mary 可以访问 S3 存储桶,并在存储桶上运行 GetObject 操作。她有一个跟踪配置为记录其账户中所有 S3 存储桶上的数据事件。因为她是 API 调用者, CloudTrail 在她的踪迹中记录一个数据事件。虽然 Bob 有权访问该存储桶,但他不是资源所有者,因此这次未在他的跟踪中记录任何事件。作为资源所有者,您会在跟踪中收到一个关于 Mary 调用的 GetObject 操作的事件。 CloudTrail 针对数据事件的每个副本对您的账户和 Mary 的账户收取费用:一个在 Mary 的跟踪中,一个在您的跟踪中。

Read-only 和只写事件

在配置跟踪或事件数据存储以记录数据事件和管理事件时,可以指定是需要只读事件、只写事件还是两者都需要。

  • 读取

    Read(读取)事件包括将读取您的资源但不进行更改的 API 操作。例如,只读事件包括 Amazon EC2 DescribeSecurityGroups 和 DescribeSubnets API 操作。这些操作仅返回有关 Amazon EC2 资源的信息,但不更改您的配置。

  • 写入

    Write(写入)事件包括将修改(或可能修改)您的资源的 API 操作。例如,Amazon EC2 RunInstances 和 TerminateInstances API 操作将修改您的实例。

示例:为单独的跟踪记录记录读取事件和写入事件

以下示例说明如何将跟踪记录配置为将账户的日志活动拆分到单独的 S3 存储桶中:一个名为 amzn-s3-demo-bucket1 的存储桶接收只读事件,另一个 amzn-s3-demo-bucket2 存储桶接收只写事件。

  1. 您创建一个跟踪并选择一个名为 amzn-s3-demo-bucket1 的 S3 存储桶来接收日志文件。然后,您更新跟踪以指定您需要 Read(读取)管理事件和数据事件。

  2. 您创建另一个跟踪并选择 S3 存储桶 amzn-s3-demo-bucket2 来接收日志文件。然后,您更新跟踪以指定您需要 Write(写入)管理事件和数据事件。

  3. Amazon EC2 DescribeInstances 和 TerminateInstances API 操作将在您的账户中执行。

  4. DescribeInstances API 操作是只读事件,它匹配第一个跟踪的设置。跟踪将记录事件并将事件传送到 amzn-s3-demo-bucket1。

  5. TerminateInstances API 操作是只写事件,它匹配第二个跟踪的设置。跟踪将记录事件并将事件传送到 amzn-s3-demo-bucket2 。

使用记录数据事件 Amazon Web Services 管理控制台

以下程序介绍如何通过使用 Amazon Web Services 管理控制台更新现有的事件数据存储或跟踪以记录数据事件。有关如何创建事件数据存储以记录数据事件的信息,请参阅为创建事件数据存储 CloudTrail 控制台活动。有关如何创建跟踪以记录数据事件的信息,请参阅使用控制台创建跟踪。

对于跟踪,根据您使用的是高级事件选择器还是基本事件选择器,记录数据事件的步骤会有所不同。您可以使用高级事件选择器记录所有资源类型的数据事件,但如果使用基本事件选择器,则只能记录 Amazon S3 存储桶和存储桶对象、 Amazon Lambda 函数以及 Amazon DynamoDB 表的数据事件。

按照以下程序更新现有的事件数据存储以记录数据事件。有关使用高级事件选择器的更多信息,请参阅本主题中的使用高级事件选择器筛选数据事件。

  1. 登录 Amazon Web Services 管理控制台 然后打开 CloudTrail 控制台在 https://console.aws.amazon.com/cloudtrail/。

  2. 在导航窗格中,在 Lake 下,选择事件数据存储。

  3. 在事件数据存储页面上,选择要更新的事件数据存储。

    注意

    您只能在包含以下内容的事件数据存储上启用数据事件 CloudTrail 事件。您无法在上启用数据事件 CloudTrail 的事件数据存储 Amazon Config 配置项目, CloudTrail 见解活动,或非活动Amazon 事件。

  4. 在详细信息页面上的数据事件中,选择编辑。

  5. 如果您尚未记录数据事件,请选择 Data events(数据事件)复选框。

  6. 对于资源类型,选择要在其上记录数据事件的资源类型。

  7. 选择日志选择器模板。您可以选择预定义的模板,也可以选择自定义来定义您自己的事件收集条件。

    您可以从以下预定义模板中进行选择:

    • 记录所有事件:选择此模板以记录所有事件。

    • 仅记录读取事件 — 选择此模板仅记录读取事件。 Read-only 事件是不会改变资源状态的事件,例如 Get* 要么 Describe* 事件。

    • 仅记录写入事件:选择此模板以仅记录写入事件。写入事件可添加、更改或删除资源、属性或构件,例如 Put*、Delete* 或 Write* 事件。

    • 仅限登录 Amazon Web Services 管理控制台 事件 — 选择此模板仅记录源自的事件 Amazon Web Services 管理控制台。

    • 排除 Amazon Web Services 服务 发起的事件 — 选择此模板进行排除 Amazon Web Services 服务 活动,其中有 eventType 的 AwsServiceEvent,以及由以下发起的事件 Amazon Web Services 服务-关联角色 (SLR)。

  8. (可选)在选择器名称中,输入用于标识选择器的名称。选择器名称是高级事件选择器的描述性名称,例如“仅记录两个 S3 桶的数据事件”。选择器名称在高级事件选择器中列为 Name,展开 JSON 视图即可查看该名称。

  9. 如果您选择了自定义,则在高级事件选择器中,将基于高级事件选择器字段的值生成表达式。

    注意

    选择器不支持使用通配符,例如 *。要将多个值与单个条件匹配,可以使用 StartsWith、EndsWith、NotStartsWith 或 NotEndsWith 明确匹配事件字段的开头或结尾。

    1. 从下面的字段中选择。

      • readOnly - readOnly 可以设置为 等于 的值为 true 要么 false。 Read-only 数据事件是不会改变资源状态的事件,例如 Get* 要么 Describe* 事件。写入事件可添加、更改或删除资源、属性或构件,例如 Put*、Delete* 或 Write* 事件。要记录 read 和 write 两种事件,请不要添加 readOnly 选择器。

      • eventName:eventName 可以使用任何运算符。您可以使用它来包含或排除记录到的任何数据事件 CloudTrail,比如 PutBucket, GetItem,或 GetSnapshotBlock。

      • eventSource:要包括或排除的事件类型。此字段可以使用任意运算符。

      • eventType:要包括或排除的事件类型。例如,可以将此字段设置为不等于 AwsServiceEvent,以排除 Amazon Web Services 服务 事件。有关事件类型的列表,请参阅 CloudTrail 记录管理、数据和网络活动事件的内容 中的 eventType。

      • 会话CredentialFromConsole — 包括或排除源自的事件 Amazon Web Services 管理控制台 会话。可以将此字段设置为等于或不等于值 true。

      • 用户Identity.arn — 包含或排除特定 IAM 身份所采取操作的事件。有关更多信息,请参阅 CloudTrail userIdentity 元素。

      • resources.ARN:您可以将任何运算符与 resources.ARN 配合使用,但如果您使用等于或不等于,则该值必须与您在模板中指定为 resources.type 的值的有效资源类型的 ARN 完全匹配。

        注意

        您不能使用 resources.ARN 字段筛选没有 ARN 的资源类型。

        有关数据事件资源的 ARN 格式的更多信息,请参阅《服务授权参考》中的 Amazon Web Services 服务的操作、资源和条件键。

    2. 对于每个字段,请选择 + 条件以根据需要添加任意数量的条件,所有条件总共可有最多 500 个指定值。例如,要从记录到事件数据存储的数据事件中排除两个 S3 存储桶的数据事件,可以将字段设置为 resources.ARN,设置不始于运算符,然后粘贴您不想为其记录事件的 S3 存储桶 ARN。

      要添加第二个 S3 存储桶,请选择 + 条件,然后重复上述说明,在 ARN 中粘贴或浏览到不同的存储桶。

      有关如何操作的信息 CloudTrail 评估多个条件,请参阅 怎么样 CloudTrail 评估一个字段的多个条件。

      注意

      对于事件数据存储上的所有选择器,最多可以有 500 个值。这包括选择器的多个值的数组,例如 eventName。如果所有选择器均为单个值,则最多可以向选择器添加 500 个条件。

    3. 根据需要,选择 + 字段以添加其他字段。为了避免错误,请不要为字段设置冲突或重复的值。例如,不要在一个选择器中将 ARN 指定为等于某个值,然后在另一个选择器中指定 ARN 不等于相同的值。

  10. 要添加需要记录数据事件的其他资源类型,请选择添加数据事件类型。重复步骤 6 至此步骤,为其他资源类型配置高级事件选择器。

  11. 查看并验证选择后,选择保存更改。

在 Amazon Web Services 管理控制台,如果您的跟踪使用高级事件选择器,则可以从记录所选资源上的所有数据事件的预定义模板中进行选择。选择了日志选择器模板后,您可以自定义模板,以仅包含最希望查看的数据事件。有关使用高级事件选择器的更多信息,请参阅本主题中的使用高级事件选择器筛选数据事件。

  1. 在 仪表板 要么 步道 的页面 CloudTrail 控制台,选择要更新的跟踪。

  2. 在详细信息页面上的数据事件中,选择编辑。

  3. 如果您尚未记录数据事件,请选择 Data events(数据事件)复选框。

  4. 对于资源类型,选择要在其上记录数据事件的资源类型。

  5. 选择日志选择器模板。您可以选择预定义的模板,也可以选择自定义来定义您自己的事件收集条件。

    您可以从以下预定义模板中进行选择:

    • 记录所有事件:选择此模板以记录所有事件。

    • 仅记录读取事件 — 选择此模板仅记录读取事件。 Read-only 事件是不会改变资源状态的事件,例如 Get* 要么 Describe* 事件。

    • 仅记录写入事件:选择此模板以仅记录写入事件。写入事件可添加、更改或删除资源、属性或构件,例如 Put*、Delete* 或 Write* 事件。

    • 仅限登录 Amazon Web Services 管理控制台 事件 — 选择此模板仅记录源自的事件 Amazon Web Services 管理控制台。

    • 排除 Amazon Web Services 服务 发起的事件 — 选择此模板进行排除 Amazon Web Services 服务 活动,其中有 eventType 的 AwsServiceEvent,以及由以下发起的事件 Amazon Web Services 服务-关联角色 (SLR)。

    注意

    为 S3 存储桶选择预定义模板可对当前存储在您的存储桶中的所有存储桶进行数据事件记录 Amazon 账户以及您在创建完跟踪后创建的所有存储桶。它还可以记录您的任何用户或角色执行的数据事件活动 Amazon 账户,即使该活动是在属于另一个存储桶上执行的 Amazon 账户。

    如果跟踪仅应用于一个区域,则选择记录所有 S3 存储桶的预定义模板可为跟踪所在的区域中的所有存储桶和您后来在该区域中创建的任何存储桶启用数据事件日志记录。它不会记录您的其他区域的 Amazon S3 存储桶的数据事件 Amazon 账户。

    如果您要为所有区域创建跟踪,则为 Lambda 函数选择预定义模板将启用当前所有函数的数据事件记录功能 Amazon 账户,以及您在完成跟踪创建后可能在任何区域创建的任何 Lambda 函数。如果您要为单个区域(针对跟踪)创建跟踪,则只能使用以下方法来完成 Amazon CLI),此选择可记录您所在地区当前所有功能的数据事件记录 Amazon 账户,以及您在创建完跟踪后可能在该区域创建的任何 Lambda 函数。它不会为在其他区域中创建的 Lambda 函数启用数据事件日志记录。

    记录所有函数的数据事件还允许记录您的任何用户或角色执行的数据事件活动 Amazon 帐户,即使该活动是在属于另一个函数的函数上执行的 Amazon 账户。

  6. (可选)在选择器名称中,输入用于标识选择器的名称。选择器名称是高级事件选择器的描述性名称,例如“仅记录两个 S3 桶的数据事件”。选择器名称在高级事件选择器中列为 Name,展开 JSON 视图即可查看该名称。

  7. 如果您选择了自定义,则在高级事件选择器中,将基于高级事件选择器字段的值生成表达式。

    注意

    选择器不支持使用通配符,例如 *。要将多个值与单个条件匹配,可以使用 StartsWith、EndsWith、NotStartsWith 或 NotEndsWith 明确匹配事件字段的开头或结尾。

    1. 从下面的字段中选择。

      • readOnly - readOnly 可以设置为 等于 的值为 true 要么 false。 Read-only 数据事件是不会改变资源状态的事件,例如 Get* 要么 Describe* 事件。写入事件可添加、更改或删除资源、属性或构件,例如 Put*、Delete* 或 Write* 事件。要记录 read 和 write 两种事件,请不要添加 readOnly 选择器。

      • eventName:eventName 可以使用任何运算符。您可以使用它来包含或排除记录到的任何数据事件 CloudTrail,比如 PutBucket, GetItem,或 GetSnapshotBlock。

      • eventSource:要包括或排除的事件类型。此字段可以使用任意运算符。

      • eventType:要包括或排除的事件类型。例如,可以将此字段设置为不等于 AwsServiceEvent,以排除 Amazon Web Services 服务 事件。有关事件类型的列表,请参阅 CloudTrail 记录管理、数据和网络活动事件的内容 中的 eventType。

      • 会话CredentialFromConsole — 包括或排除源自的事件 Amazon Web Services 管理控制台 会话。可以将此字段设置为等于或不等于值 true。

      • 用户Identity.arn — 包含或排除特定 IAM 身份所采取操作的事件。有关更多信息,请参阅 CloudTrail userIdentity 元素。

      • resources.ARN:您可以将任何运算符与 resources.ARN 配合使用,但如果您使用等于或不等于,则该值必须与您在模板中指定为 resources.type 的值的有效资源类型的 ARN 完全匹配。

        注意

        您不能使用 resources.ARN 字段筛选没有 ARN 的资源类型。

        有关数据事件资源的 ARN 格式的更多信息,请参阅《服务授权参考》中的 Amazon Web Services 服务的操作、资源和条件键。

    2. 对于每个字段,请选择 + 条件以根据需要添加任意数量的条件,所有条件总共可有最多 500 个指定值。例如,要从记录到事件数据存储的数据事件中排除两个 S3 存储桶的数据事件,可以将字段设置为 resources.ARN,设置不始于运算符,然后粘贴您不想为其记录事件的 S3 存储桶 ARN。

      要添加第二个 S3 存储桶,请选择 + 条件,然后重复上述说明,在 ARN 中粘贴或浏览到不同的存储桶。

      有关如何操作的信息 CloudTrail 评估多个条件,请参阅 怎么样 CloudTrail 评估一个字段的多个条件。

      注意

      对于事件数据存储上的所有选择器,最多可以有 500 个值。这包括选择器的多个值的数组,例如 eventName。如果所有选择器均为单个值,则最多可以向选择器添加 500 个条件。

    3. 根据需要,选择 + 字段以添加其他字段。为了避免错误,请不要为字段设置冲突或重复的值。例如,不要在一个选择器中将 ARN 指定为等于某个值,然后在另一个选择器中指定 ARN 不等于相同的值。

  8. 要添加需要记录数据事件的其他资源类型,请选择添加数据事件类型。重复步骤 4 至此步骤,为资源类型配置高级事件选择器。

  9. 查看并验证选择后,选择保存更改。

按照以下程序,使用基本事件选择器更新现有跟踪以记录数据事件。

  1. 登录 Amazon Web Services 管理控制台 然后打开 CloudTrail 控制台在 https://console.aws.amazon.com/cloudtrail/。

  2. 打开 步道 的页面 CloudTrail 控制台并选择跟踪名称。

    注意

    虽然您可以编辑现有跟踪以记录数据事件,但作为最佳实践,请考虑专门创建单独的跟踪以记录数据事件。

  3. 对于 Data event(数据事件),选择 Edit(编辑)。

  4. 对于 Amazon S3 存储桶:

    1. 对于 Data event source(数据事件源),选择 S3。

    2. 您可以选择记录 All current and future S3 buckets(所有当前和未来 S3 存储桶),也可以指定单个存储桶或函数。默认情况下,记录所有当前和未来 S3 存储桶的数据事件。

      注意

      保持默认值 所有当前和未来的 S3 存储桶 选项为您的当前所有存储桶启用数据事件记录功能 Amazon 账户以及您在创建完跟踪后创建的所有存储桶。它还可以记录您的任何用户或角色执行的数据事件活动 Amazon 账户,即使该活动是在属于另一个存储桶上执行的 Amazon 账户。

      如果您要为单个区域创建跟踪(通过使用 Amazon CLI),选择 选择您账户中的所有 S3 存储桶 选项为与您的跟踪位于同一区域的所有存储桶以及您稍后在该区域创建的任何存储分区启用数据事件记录功能。它不会记录您的其他区域的 Amazon S3 存储桶的数据事件 Amazon 账户。

    3. 如果保留默认值 All current and future S3 buckets(所有当前和未来 S3 存储桶),则选择记录 Read(读取)事件、Write(写入)事件,还是记录两者。

    4. 要选择单个存储桶,请清空 All current and future S3 buckets(所有当前和未来 S3 存储桶)的 Read(读取)和Write(写入)复选框。在 Individual bucket selection(单个存储桶选择)中,浏览要在其上记录数据事件的存储桶。要查找特定存储桶,键入所需存储桶的存储桶前缀。您可以在此窗口中选择多个存储桶。选择添加存储桶,记录更多存储桶的数据事件。选择记录 Read(读取)事件(如 GetObject)、Write(写入)事件(如 PutObject)或同时记录两种事件。

      此设置优先于为各个存储桶配置的个别设置。例如,如果指定记录所有 S3 存储桶的 Read 事件,然后选择为数据事件日志记录添加一个特定存储桶,则所添加存储桶的 Read 已经是选中状态。您无法清除此选择。只能配置 Write 选项。

      要从日志记录中删除存储桶,请选择 X。

  5. 要添加需要记录数据事件的其他资源类型,请选择添加数据事件类型。

  6. 对于 Lambda 函数:

    1. 对于数据事件源,选择 Lambda。

    2. 在 Lambda 函数中,选择所有区域记录所有 Lambda 函数,或选择将函数作为 ARN 输入以记录特定函数上的数据事件。

      要记录 Amazon 账户中的所有 Lambda 函数的数据事件,请选择记录所有当前和未来函数。此设置优先于为各个函数配置的个别设置。将记录所有函数,即便这些函数未显示。

      注意

      如果为所有区域创建了一个跟踪,则此选择将为您的 Amazon 账户中当前包含的所有函数以及您在创建跟踪后可能在任何区域中创建的任何 Lambda 函数启用数据事件日志记录。如果您要为单个区域创建跟踪(通过使用 Amazon CLI),此选择可记录您所在地区当前所有功能的数据事件记录 Amazon 账户,以及您在创建完跟踪后可能在该区域创建的任何 Lambda 函数。它不会为在其他区域中创建的 Lambda 函数启用数据事件日志记录。

      记录所有函数的数据事件还允许记录您的任何用户或角色执行的数据事件活动 Amazon 帐户,即使该活动是在属于另一个函数的函数上执行的 Amazon 账户。

    3. 如果选择将函数作为 ARN 输入,则输入 Lambda 函数的 ARN。

      注意

      如果您的账户中有超过 15,000 个 Lambda 函数,则无法查看或选择账户中的所有函数 CloudTrail 创建跟踪时的控制台。您仍可以选择该选项来记录所有函数,即使未显示这些函数也是如此。如果您要记录特定函数的数据事件,则可手动添加一个函数(如果您知道其 ARN)。你也可以在控制台中完成跟踪的创建,然后使用 Amazon CLI 还有 put-event-selectors 命令为特定 Lambda 函数配置数据事件记录。有关更多信息,请参阅 使用管理路径 Amazon CLI。

  7. 要添加需要记录数据事件的其他资源类型,请选择添加数据事件类型。

  8. 对于 DynamoDB 表:

    1. 对于 Data event source(数据事件源),选择 DynamoDB。

    2. 在 DynamoDB table selection(DynamoDB 表选择)中,选择 Browse(浏览)以选择一个表,或粘贴到您有权访问的 DynamoDB 表的 ARN 中。DynamoDB 表 ARN 使用以下格式:

      arn:partition:dynamodb:region:account_ID:table/table_name

      要添加另一个表,请选择 Add row(添加行),然后浏览到某个表或粘贴到您有权访问的表的 ARN 中。

  9. 选择保存更改。

使用记录数据事件 Amazon Command Line Interface

您可以使用 Amazon CLI配置跟踪以记录数据事件。

使用记录轨迹的数据事件 Amazon CLI

您可以使用 Amazon CLI配置您的跟踪记录以记录管理事件和数据事件。

注意
  • 请注意,如果您的账户正在记录管理事件的多个副本,将会产生费用。记录数据事件始终需要收取费用。有关更多信息,请参阅Amazon CloudTrail 定价。

  • 您可以使用高级事件选择器或基本事件选择器,但不能同时使用两者。如果将高级事件选择器应用于跟踪,则所有现有的基本事件选择器都将被覆盖。

  • 如果您的跟踪使用基本的事件选择器,则您只能记录以下资源类型:

    • AWS::DynamoDB::Table

    • AWS::Lambda::Function

    • AWS::S3::Object

    要记录其他资源类型,您需要使用高级事件选择器。要将跟踪转换为高级事件选择器,请运行 get-event-selectors 命令以确认当前事件选择器,然后将高级事件选择器配置为与以前的事件选择器的覆盖范围相匹配,然后为要记录数据事件的任何资源类型添加选择器。

  • 您可以使用高级事件选择器根据支持的高级事件选择器字段支持的高级事件选择器字段的值来进行筛选,从而使您能够仅记录感兴趣的数据事件。有关配置这些字段的更多信息,请参阅《Amazon CloudTrail API 参考》中的 AdvancedFieldSelector 和本指南中的 使用高级事件选择器筛选数据事件。

要查看您的跟踪是否正在记录管理事件和数据事件,请运行 get-event-selectors 命令。

aws cloudtrail get-event-selectors --trail-name TrailName

该命令将返回跟踪的事件选择器。

使用高级事件选择器记录跟踪的数据事件

注意

如果将高级事件选择器应用于跟踪,则所有现有的基本事件选择器都将被覆盖。在配置高级事件选择器之前,请运行 get-event-selectors 命令以确认当前事件选择器,然后将高级事件选择器配置为与以前的事件选择器的覆盖范围相匹配,然后为要记录的任何其他数据事件添加选择器。

以下示例为名为的跟踪创建自定义高级事件选择器 TrailName 包括读取和写入管理事件(省略 readOnly 选择器), PutObject 和 DeleteObject 所有 Amazon S3 的数据事件 bucket/prefix 除名为的存储桶之外的组合 amzn-s3-demo-bucket 以及数据事件 Amazon Lambda 名为的函数 MyLambdaFunction。由于这些都是自定义高级事件选择器,因此每组选择器都有一个描述性名称。请注意,尾随斜杠是 S3 存储桶的 ARN 值的一部分。

aws cloudtrail put-event-selectors --trail-name TrailName --advanced-event-selectors '[ { "Name": "Log readOnly and writeOnly management events", "FieldSelectors": [ { "Field": "eventCategory", "Equals": ["Management"] } ] }, { "Name": "Log PutObject and DeleteObject events for all but one bucket", "FieldSelectors": [ { "Field": "eventCategory", "Equals": ["Data"] }, { "Field": "resources.type", "Equals": ["AWS::S3::Object"] }, { "Field": "eventName", "Equals": ["PutObject","DeleteObject"] }, { "Field": "resources.ARN", "NotStartsWith": ["arn:aws:s3:::amzn-s3-demo-bucket/"] } ] }, { "Name": "Log data plane actions on MyLambdaFunction", "FieldSelectors": [ { "Field": "eventCategory", "Equals": ["Data"] }, { "Field": "resources.type", "Equals": ["AWS::Lambda::Function"] }, { "Field": "resources.ARN", "Equals": ["arn:aws:lambda:us-east-2:111122223333:function/MyLambdaFunction"] } ] } ]'

以下示例返回为跟踪配置的高级事件选择器。

{ "AdvancedEventSelectors": [ { "Name": "Log readOnly and writeOnly management events", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Management" ] } ] }, { "Name": "Log PutObject and DeleteObject events for all but one bucket", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Data" ] }, { "Field": "resources.type", "Equals": [ "AWS::S3::Object" ] }, { "Field": "resources.ARN", "NotStartsWith": [ "arn:aws:s3:::amzn-s3-demo-bucket/" ] }, ] }, { "Name": "Log data plane actions on MyLambdaFunction", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Data" ] }, { "Field": "resources.type", "Equals": [ "AWS::Lambda::Function" ] }, { "Field": "eventName", "Equals": [ "Invoke" ] }, { "Field": "resources.ARN", "Equals": [ "arn:aws:lambda:us-east-2:111122223333:function/MyLambdaFunction" ] } ] } ], "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/TrailName" }

使用高级事件选择器记录 Amazon S3 存储桶的所有 Amazon S3 事件

注意

如果将高级事件选择器应用于跟踪,则所有现有的基本事件选择器都将被覆盖。

以下示例说明如何配置您的跟踪以包含特定 S3 存储桶中的所有 Amazon S3 对象的所有数据事件。S3 事件在 resources.type 字段中的值为 AWS::S3::Object。由于 S3 对象和 S3 存储桶的 ARN 值略有不同,因此必须为 resources.ARN 添加 StartsWith 运算符以捕获所有事件。

aws cloudtrail put-event-selectors --trail-name TrailName --region region \ --advanced-event-selectors \ '[ { "Name": "S3EventSelector", "FieldSelectors": [ { "Field": "eventCategory", "Equals": ["Data"] }, { "Field": "resources.type", "Equals": ["AWS::S3::Object"] }, { "Field": "resources.ARN", "StartsWith": ["arn:partition:s3:::amzn-s3-demo-bucket/"] } ] } ]'

该命令将返回以下示例输出。

{ "TrailARN": "arn:aws:cloudtrail:region:account_ID:trail/TrailName", "AdvancedEventSelectors": [ { "Name": "S3EventSelector", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Data" ] }, { "Field": "resources.type", "Equals": [ "AWS::S3::Object" ] }, { "Field": "resources.ARN", "StartsWith": [ "arn:partition:s3:::amzn-s3-demo-bucket/" ] } ] } ] }

登录 Amazon S3 Amazon Outposts 使用高级事件选择器进行事件

注意

如果将高级事件选择器应用于跟踪,则所有现有的基本事件选择器都将被覆盖。

以下示例说明如何配置您的跟踪以包含您的 Outpost 中所有 Amazon S3 on Outposts 对象的所有数据事件。

aws cloudtrail put-event-selectors --trail-name TrailName --region region \ --advanced-event-selectors \ '[ { "Name": "OutpostsEventSelector", "FieldSelectors": [ { "Field": "eventCategory", "Equals": ["Data"] }, { "Field": "resources.type", "Equals": ["AWS::S3Outposts::Object"] } ] } ]'

该命令将返回以下示例输出。

{ "TrailARN": "arn:aws:cloudtrail:region:account_ID:trail/TrailName", "AdvancedEventSelectors": [ { "Name": "OutpostsEventSelector", "FieldSelectors": [ { "Field": "eventCategory", "Equals": [ "Data" ] }, { "Field": "resources.type", "Equals": [ "AWS::S3Outposts::Object" ] } ] } ] }

使用基本事件选择器记录事件

下面是显示基本事件选择器的 get-event-selectors 命令结果示例。默认情况下,当您使用创建跟踪时 Amazon CLI,跟踪记录所有管理事件。默认情况下,跟踪记录不记录数据事件。

{ "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/TrailName", "EventSelectors": [ { "IncludeManagementEvents": true, "DataResources": [], "ReadWriteType": "All" } ] }

要将跟踪配置为记录管理事件和数据事件,请运行 put-event-selectors 命令。

以下示例说明如何使用基本事件选择器配置跟踪,以包含两个 S3 存储桶前缀中 S3 对象的所有管理事件和数据事件。您可以为一个跟踪指定 1 至 5 个事件选择器。您可以为一个跟踪指定 1 至 250 个数据资源。

注意

如果您选择使用基本事件选择器限制数据事件,则最多只能有 250 个 S3 数据资源。

aws cloudtrail put-event-selectors --trail-name TrailName --event-selectors '[{ "ReadWriteType": "All", "IncludeManagementEvents":true, "DataResources": [{ "Type": "AWS::S3::Object", "Values": ["arn:aws:s3:::amzn-s3-demo-bucket1/prefix", "arn:aws:s3:::amzn-s3-demo-bucket2;/prefix2"] }] }]'

该命令将返回为跟踪配置的事件选择器。

{ "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/TrailName", "EventSelectors": [ { "IncludeManagementEvents": true, "DataResources": [ { "Values": [ "arn:aws:s3:::amzn-s3-demo-bucket1/prefix", "arn:aws:s3:::amzn-s3-demo-bucket2/prefix2", ], "Type": "AWS::S3::Object" } ], "ReadWriteType": "All" } ] }

使用记录数据事件 Amazon 软件开发工具包

运行 GetEventSelectors 操作以查看您的跟踪是否正在记录数据事件。您可以通过运行,将跟踪配置为记录数据事件 PutEventSelectors 操作。有关更多信息,请参阅 Amazon CloudTrail API 参考。