software.amazon.awssdk.services.cloudtrail.model

Interface EventSelector.Builder

All Superinterfaces:

Buildable, CopyableBuilder<EventSelector.Builder,EventSelector>, SdkBuilder<EventSelector.Builder,EventSelector>, SdkPojo

Enclosing class:

EventSelector

public static interface EventSelector.Builder
extends SdkPojo, CopyableBuilder<EventSelector.Builder,EventSelector>

Method Summary

Modifier and Type	Method and Description
EventSelector.Builder	dataResources(Collection<DataResource> dataResources) CloudTrail supports data event logging for Amazon S3 objects, Lambda functions, and Amazon DynamoDB tables with basic event selectors.
EventSelector.Builder	dataResources(Consumer<DataResource.Builder>... dataResources) CloudTrail supports data event logging for Amazon S3 objects, Lambda functions, and Amazon DynamoDB tables with basic event selectors.
EventSelector.Builder	dataResources(DataResource... dataResources) CloudTrail supports data event logging for Amazon S3 objects, Lambda functions, and Amazon DynamoDB tables with basic event selectors.
EventSelector.Builder	excludeManagementEventSources(Collection<String> excludeManagementEventSources) An optional list of service event sources from which you do not want management events to be logged on your trail.
EventSelector.Builder	excludeManagementEventSources(String... excludeManagementEventSources) An optional list of service event sources from which you do not want management events to be logged on your trail.
EventSelector.Builder	includeManagementEvents(Boolean includeManagementEvents) Specify if you want your event selector to include management events for your trail.
EventSelector.Builder	readWriteType(ReadWriteType readWriteType) Specify if you want your trail to log read-only events, write-only events, or all.
EventSelector.Builder	readWriteType(String readWriteType) Specify if you want your trail to log read-only events, write-only events, or all.

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

equalsBySdkFields, sdkFields

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Method Detail

readWriteType

EventSelector.Builder readWriteType(String 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

ReadWriteType, ReadWriteType

readWriteType

EventSelector.Builder readWriteType(ReadWriteType 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.

Parameters:

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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

ReadWriteType, ReadWriteType

includeManagementEvents

EventSelector.Builder includeManagementEvents(Boolean includeManagementEvents)

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.

Parameters:

includeManagementEvents - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

dataResources

EventSelector.Builder dataResources(Collection<DataResource> dataResources)

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.

Parameters:

dataResources - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

dataResources

EventSelector.Builder dataResources(DataResource... dataResources)

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.

Parameters:

dataResources - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

dataResources

EventSelector.Builder dataResources(Consumer<DataResource.Builder>... dataResources)

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.

This is a convenience method that creates an instance of the DataResource.Builder avoiding the need to create one manually via DataResource.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to #dataResources(List).

Parameters:

dataResources - a consumer that will call methods on DataResource.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

#dataResources(java.util.Collection)

excludeManagementEventSources

EventSelector.Builder excludeManagementEventSources(Collection<String> excludeManagementEventSources)

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.

Parameters:

excludeManagementEventSources - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

excludeManagementEventSources

EventSelector.Builder excludeManagementEventSources(String... excludeManagementEventSources)

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.

Parameters:

excludeManagementEventSources - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.