Struct aws_sdk_cloudtrail::types::EventSelector
source · #[non_exhaustive]pub struct EventSelector {
pub read_write_type: Option<ReadWriteType>,
pub include_management_events: Option<bool>,
pub data_resources: Option<Vec<DataResource>>,
pub exclude_management_event_sources: Option<Vec<String>>,
}
Expand description
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.
You cannot apply both event selectors and advanced event selectors to a trail.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.read_write_type: Option<ReadWriteType>
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
.
include_management_events: Option<bool>
Specify if you want your event selector to include management events for your trail.
For more information, see Management Events in the CloudTrail User Guide.
By default, the value is true
.
The first copy of management events is free. You are charged for additional copies of management events that you are logging on any subsequent trail in the same Region. For more information about CloudTrail pricing, see CloudTrail Pricing.
data_resources: Option<Vec<DataResource>>
CloudTrail supports data event logging for Amazon S3 objects, Lambda functions, and Amazon DynamoDB tables with basic event selectors. 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 CloudTrail in the CloudTrail User Guide.
exclude_management_event_sources: Option<Vec<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 Key Management Service or Amazon RDS Data API events by containing kms.amazonaws.com
or rdsdata.amazonaws.com
. By default, ExcludeManagementEventSources
is empty, and KMS and Amazon RDS Data API events are logged to your trail. You can exclude management event sources only in Regions that support the event source.
Implementations§
source§impl EventSelector
impl EventSelector
sourcepub fn read_write_type(&self) -> Option<&ReadWriteType>
pub fn read_write_type(&self) -> Option<&ReadWriteType>
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
.
sourcepub fn include_management_events(&self) -> Option<bool>
pub fn include_management_events(&self) -> Option<bool>
Specify if you want your event selector to include management events for your trail.
For more information, see Management Events in the CloudTrail User Guide.
By default, the value is true
.
The first copy of management events is free. You are charged for additional copies of management events that you are logging on any subsequent trail in the same Region. For more information about CloudTrail pricing, see CloudTrail Pricing.
sourcepub fn data_resources(&self) -> &[DataResource]
pub fn data_resources(&self) -> &[DataResource]
CloudTrail supports data event logging for Amazon S3 objects, Lambda functions, and Amazon DynamoDB tables with basic event selectors. 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 CloudTrail in the CloudTrail User Guide.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .data_resources.is_none()
.
sourcepub fn exclude_management_event_sources(&self) -> &[String]
pub fn exclude_management_event_sources(&self) -> &[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 Key Management Service or Amazon RDS Data API events by containing kms.amazonaws.com
or rdsdata.amazonaws.com
. By default, ExcludeManagementEventSources
is empty, and KMS and Amazon RDS Data API events are logged to your trail. You can exclude management event sources only in Regions that support the event source.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .exclude_management_event_sources.is_none()
.
source§impl EventSelector
impl EventSelector
sourcepub fn builder() -> EventSelectorBuilder
pub fn builder() -> EventSelectorBuilder
Creates a new builder-style object to manufacture EventSelector
.
Trait Implementations§
source§impl Clone for EventSelector
impl Clone for EventSelector
source§fn clone(&self) -> EventSelector
fn clone(&self) -> EventSelector
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for EventSelector
impl Debug for EventSelector
source§impl PartialEq for EventSelector
impl PartialEq for EventSelector
source§fn eq(&self, other: &EventSelector) -> bool
fn eq(&self, other: &EventSelector) -> bool
self
and other
values to be equal, and is used
by ==
.impl StructuralPartialEq for EventSelector
Auto Trait Implementations§
impl Freeze for EventSelector
impl RefUnwindSafe for EventSelector
impl Send for EventSelector
impl Sync for EventSelector
impl Unpin for EventSelector
impl UnwindSafe for EventSelector
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more