Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-143021,9861.6 MB

Lists the trials in your account. Specify an experiment name to limit the list to the trials that are part of that experiment. Specify a trial component name to limit the list to the trials that associated with that trial component. The list can be filtered to show only trials that were created in a specific time range. The list can be sorted by trial name or creation time.

post/#X-Amz-Target=SageMaker.ListTrials

Query parameters

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'SageMaker.ListTrials' required

Request body

ExperimentNamestring

A filter that returns only trials that are part of the specified experiment.

TrialComponentNamestring

A filter that returns only trials that are associated with the specified trial component.

CreatedAfterstring date-time

A filter that returns only trials created after the specified time.

CreatedBeforestring date-time

A filter that returns only trials created before the specified time.

SortBy'Name' | 'CreationTime'

The property used to sort results. The default value is <code>CreationTime</code>.

SortOrder'Ascending' | 'Descending'

The sort order. The default value is <code>Descending</code>.

MaxResultsinteger

The maximum number of trials to return in the response. The default value is 10.

NextTokenstring

If the previous call to <code>ListTrials</code> didn't return the full set of trials, the call returns a token for getting the next set of trials.

Response

Success

NextTokenstring

A token for getting the next set of trials, if there are any.