Package software.amazon.awscdk.services.cloudtrail

Class CfnTrail.EventSelectorProperty.Builder

java.lang.Object
software.amazon.awscdk.services.cloudtrail.CfnTrail.EventSelectorProperty.Builder
All Implemented Interfaces:
software.amazon.jsii.Builder<CfnTrail.EventSelectorProperty>
Enclosing interface:
CfnTrail.EventSelectorProperty
@Stability(Stable) public static final class CfnTrail.EventSelectorProperty.Builder extends Object implements software.amazon.jsii.Builder<CfnTrail.EventSelectorProperty>
A builder for CfnTrail.EventSelectorProperty

  • Constructor Details

    • Builder

      public Builder()

  • Method Details

    • dataResources

      @Stability(Stable) public CfnTrail.EventSelectorProperty.Builder dataResources(IResolvable dataResources)
      Sets the value of CfnTrail.EventSelectorProperty.getDataResources()
      Parameters:
      dataResources - CloudTrail supports data event logging for Amazon S3 objects in standard S3 buckets, AWS 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 AWS CloudTrail in the AWS CloudTrail User Guide .

      To log data events for all other resource types including objects stored in directory buckets , you must use AdvancedEventSelectors . You must also use AdvancedEventSelectors if you want to filter on the eventName field.

      Returns:
      this

    • dataResources

      @Stability(Stable) public CfnTrail.EventSelectorProperty.Builder dataResources(List<? extends Object> dataResources)
      Sets the value of CfnTrail.EventSelectorProperty.getDataResources()
      Parameters:
      dataResources - CloudTrail supports data event logging for Amazon S3 objects in standard S3 buckets, AWS 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 AWS CloudTrail in the AWS CloudTrail User Guide .

      To log data events for all other resource types including objects stored in directory buckets , you must use AdvancedEventSelectors . You must also use AdvancedEventSelectors if you want to filter on the eventName field.

      Returns:
      this

    • excludeManagementEventSources

      @Stability(Stable) public CfnTrail.EventSelectorProperty.Builder excludeManagementEventSources(List<String> excludeManagementEventSources)
      Sets the value of CfnTrail.EventSelectorProperty.getExcludeManagementEventSources()
      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 AWS Key Management Service or Amazon RDS Data API events by containing kms.amazonaws.com or rdsdata.amazonaws.com . By default, ExcludeManagementEventSources is empty, and AWS 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:
      this

    • includeManagementEvents

      @Stability(Stable) public CfnTrail.EventSelectorProperty.Builder includeManagementEvents(Boolean includeManagementEvents)
      Sets the value of CfnTrail.EventSelectorProperty.getIncludeManagementEvents()
      Parameters:
      includeManagementEvents - 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 .

      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 AWS CloudTrail Pricing .

      Returns:
      this

    • includeManagementEvents

      @Stability(Stable) public CfnTrail.EventSelectorProperty.Builder includeManagementEvents(IResolvable includeManagementEvents)
      Sets the value of CfnTrail.EventSelectorProperty.getIncludeManagementEvents()
      Parameters:
      includeManagementEvents - 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 .

      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 AWS CloudTrail Pricing .

      Returns:
      this

    • readWriteType

      @Stability(Stable) public CfnTrail.EventSelectorProperty.Builder readWriteType(String readWriteType)
      Sets the value of CfnTrail.EventSelectorProperty.getReadWriteType()
      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:
      this

    • build

      @Stability(Stable) public CfnTrail.EventSelectorProperty build()
      Builds the configured instance.
      Specified by:
      build in interface software.amazon.jsii.Builder<CfnTrail.EventSelectorProperty>
      Returns:
      a new instance of CfnTrail.EventSelectorProperty
      Throws:
      NullPointerException - if any required attribute was not provided