Skip to content

CloudTrail  >  Operations  >  list_queries

list_queries

Operation

list_queries async

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

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: QueryStatus | 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.