Looks up API activity events captured by CloudTrail that create, update, or delete resources in your account. Events for a region can be looked up for the times in which you had CloudTrail turned on in that region during the last seven days. Lookup supports the following attributes:
-
Event ID
-
Event name
-
Resource name
-
Resource type
-
User name
All attributes are optional. The default number of results returned is 10, 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 one per second per account. If this limit is exceeded, a throttling error occurs.
Events that occurred during the selected time range will not be available for lookup if CloudTrail logging was not enabled when the events occurred.
/// Occurs when an invalid lookup attribute is specified.
///
/// This exception is thrown if the limit specified is invalid.
///
/// Invalid token or token that was previously used in a request with different parameters.
/// This exception is thrown if the token is invalid.
///
/// 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.
///