Skip to content

Get Event Selectors

cloudtrail_get_event_selectors R Documentation

Describes the settings for the event selectors that you configured for your trail

Description

Describes the settings for the event selectors that you configured for your trail. The information returned for your event selectors includes the following:

  • If your event selector includes read-only events, write-only events, or all events. This applies to both management events and data events.

  • If your event selector includes management events.

  • If your event selector includes data events, the resources on which you are logging data events.

For more information about logging management and data events, see the following topics in the CloudTrail User Guide:

Usage

cloudtrail_get_event_selectors(TrailName)

Arguments

TrailName

[required] Specifies the name of the trail or trail ARN. If you specify a trail name, the string must meet the following requirements:

  • Contain only ASCII letters (a-z, A-Z), numbers (0-9), periods (.), underscores (_), or dashes (-)

  • Start with a letter or number, and end with a letter or number

  • Be between 3 and 128 characters

  • Have no adjacent periods, underscores or dashes. Names like ⁠my-_namespace⁠ and my--namespace are not valid.

  • Not be in IP address format (for example, 192.168.5.4)

If you specify a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

Value

A list with the following syntax:

list(
  TrailARN = "string",
  EventSelectors = list(
    list(
      ReadWriteType = "ReadOnly"|"WriteOnly"|"All",
      IncludeManagementEvents = TRUE|FALSE,
      DataResources = list(
        list(
          Type = "string",
          Values = list(
            "string"
          )
        )
      ),
      ExcludeManagementEventSources = list(
        "string"
      )
    )
  ),
  AdvancedEventSelectors = list(
    list(
      Name = "string",
      FieldSelectors = list(
        list(
          Field = "string",
          Equals = list(
            "string"
          ),
          StartsWith = list(
            "string"
          ),
          EndsWith = list(
            "string"
          ),
          NotEquals = list(
            "string"
          ),
          NotStartsWith = list(
            "string"
          ),
          NotEndsWith = list(
            "string"
          )
        )
      )
    )
  )
)

Request syntax

svc$get_event_selectors(
  TrailName = "string"
)