AWS SDK Version 3 for .NET
API Reference

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.

Looks up management events or CloudTrail Insights events that are captured by CloudTrail. You can look up events that occurred in a region within the last 90 days. Lookup supports the following attributes for management events:

Lookup supports the following attributes for Insights events:

All attributes are optional. The default number of results returned is 50, with a maximum of 50 possible. The response includes a token that you can use to get the next page of results.

The rate of lookup requests is limited to two per second per account. If this limit is exceeded, a throttling error occurs.


For .NET Core and PCL this operation is only available in asynchronous form. Please refer to LookupEventsAsync.

Namespace: Amazon.CloudTrail
Assembly: AWSSDK.CloudTrail.dll
Version: 3.x.y.z


public virtual LookupEventsResponse LookupEvents(
         LookupEventsRequest request
Type: Amazon.CloudTrail.Model.LookupEventsRequest

Container for the necessary parameters to execute the LookupEvents service method.

Return Value
The response from the LookupEvents service method, as returned by CloudTrail.


InvalidEventCategoryException Occurs if an event category that is not valid is specified as a value of EventCategory.
InvalidLookupAttributesException Occurs when an invalid lookup attribute is specified.
InvalidMaxResultsException This exception is thrown if the limit specified is invalid.
InvalidNextTokenException Invalid token or token that was previously used in a request with different parameters. This exception is thrown if the token is invalid.
InvalidTimeRangeException Occurs if the timestamp values are invalid. Either the start time occurs after the end time or the time range is outside the range of possible values.
OperationNotPermittedException This exception is thrown when the requested operation is not permitted.
UnsupportedOperationException This exception is thrown when the requested operation is not supported.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also