Skip to content

CloudTrail  >  Operations  >  list_queries

list_queries

Operation

list_queries async 

list_queries(input: ListQueriesInput, plugins: list[Plugin] | None = None) -> ListQueriesOutput
Warning

CloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see CloudTrail Lake availability change.

Returns a list of queries and query statuses for the past seven days. You must specify an ARN value for EventDataStore. Optionally, to shorten the list of results, you can specify a time range, formatted as timestamps, by adding StartTime and EndTime parameters, and a QueryStatus value. Valid values for QueryStatus include QUEUED, RUNNING, FINISHED, FAILED, TIMED_OUT, or CANCELLED.

Parameters:

Name Type Description Default
input ListQueriesInput

An instance of ListQueriesInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
ListQueriesOutput

An instance of ListQueriesOutput.

Input

ListQueriesInput dataclass

Dataclass for ListQueriesInput structure.

Attributes

end_time class-attribute instance-attribute 
end_time: datetime | None = None

Use with StartTime to bound a ListQueries request, and limit its results to only those queries run within a specified time period.

event_data_store class-attribute instance-attribute 
event_data_store: str | None = None

The ARN (or the ID suffix of the ARN) of an event data store on which queries were run.

max_results class-attribute instance-attribute 
max_results: int | None = None

The maximum number of queries to show on a page.

next_token class-attribute instance-attribute 
next_token: str | None = None

A token you can use to get the next page of results.

query_status class-attribute instance-attribute 
query_status: str | None = None

The status of queries that you want to return in results. Valid values for QueryStatus include QUEUED, RUNNING, FINISHED, FAILED, TIMED_OUT, or CANCELLED.

start_time class-attribute instance-attribute 
start_time: datetime | None = None

Use with EndTime to bound a ListQueries request, and limit its results to only those queries run within a specified time period.

Output

ListQueriesOutput dataclass

Dataclass for ListQueriesOutput structure.

Attributes

next_token class-attribute instance-attribute 
next_token: str | None = None

A token you can use to get the next page of results.

queries class-attribute instance-attribute 
queries: list[Query] | None = None

Lists matching query results, and shows query ID, status, and creation time of each query.

response_metadata class-attribute instance-attribute 
response_metadata: ResponseMetadata = field(default=EMPTY_RESPONSE_METADATA, repr=False, compare=False)

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.