AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::CloudTrail::Types::EventSelector

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing EventSelector as input to an Aws::Client method, you can use a vanilla Hash:

{
  read_write_type: "ReadOnly", # accepts ReadOnly, WriteOnly, All
  include_management_events: false,
  data_resources: [
    {
      type: "String",
      values: ["String"],
    },
  ],
  exclude_management_event_sources: ["String"],
}

Use event selectors to further specify the management and data event settings for your trail. By default, trails created without specific event selectors will be configured to log all read and write management events, and no data events. When an event occurs in your account, CloudTrail evaluates the event selector for all trails. For each trail, if the event matches any event selector, the trail processes and logs the event. If the event doesn't match any event selector, the trail doesn't log the event.

You can configure up to five event selectors for a trail.

Instance Attribute Summary collapse

Instance Attribute Details

#data_resourcesArray<Types::DataResource>

CloudTrail supports data event logging for Amazon S3 objects and AWS Lambda functions. You can specify up to 250 resources for an individual event selector, but the total number of data resources cannot exceed 250 across all event selectors in a trail. This limit does not apply if you configure resource logging for all data events.

For more information, see Data Events and Limits in AWS CloudTrail in the AWS CloudTrail User Guide.

Returns:

  • (Array<Types::DataResource>)

    CloudTrail supports data event logging for Amazon S3 objects and AWS Lambda functions.

#exclude_management_event_sourcesArray<String>

An optional list of service event sources from which you do not want management events to be logged on your trail. In this release, the list can be empty (disables the filter), or it can filter out AWS Key Management Service events by containing "kms.amazonaws.com". By default, ExcludeManagementEventSources is empty, and AWS KMS events are included in events that are logged to your trail.

Returns:

  • (Array<String>)

    An optional list of service event sources from which you do not want management events to be logged on your trail.

#include_management_eventsBoolean

Specify if you want your event selector to include management events for your trail.

For more information, see Management Events in the AWS CloudTrail User Guide.

By default, the value is true.

Returns:

  • (Boolean)

    Specify if you want your event selector to include management events for your trail.

#read_write_typeString

Specify if you want your trail to log read-only events, write-only events, or all. For example, the EC2 GetConsoleOutput is a read-only API operation and RunInstances is a write-only API operation.

By default, the value is All.

Possible values:

  • ReadOnly
  • WriteOnly
  • All

Returns:

  • (String)

    Specify if you want your trail to log read-only events, write-only events, or all.