Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1423128111.3 KB

Lists the start times of the available aggregated profiles of a profiling group for an aggregation period within the specified time range.

get/profilingGroups/{profilingGroupName}/profileTimes#endTime&period&startTime

Path parameters

profilingGroupNamestring required

The name of the profiling group.

Query parameters

endTimestring date-time required

The end time of the time range from which to list the profiles.

maxResultsinteger

The maximum number of profile time results returned by <code>ListProfileTimes</code> in paginated output. When this parameter is used, <code>ListProfileTimes</code> only returns <code>maxResults</code> results in a single page with a <code>nextToken</code> response element. The remaining results of the initial request can be seen by sending another <code>ListProfileTimes</code> request with the returned <code>nextToken</code> value.

nextTokenstring
<p>The <code>nextToken</code> value returned from a previous paginated <code>ListProfileTimes</code> request where <code>maxResults</code> was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the <code>nextToken</code> value. </p> <note> <p>This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.</p> </note>
orderBy'TimestampDescending' | 'TimestampAscending'

The order (ascending or descending by start time of the profile) to use when listing profiles. Defaults to <code>TIMESTAMP_DESCENDING</code>.

period'PT5M' | 'PT1H' | 'P1D' required
<p> The aggregation period. This specifies the period during which an aggregation profile collects posted agent profiles for a profiling group. There are 3 valid values. </p> <ul> <li> <p> <code>P1D</code> — 1 day </p> </li> <li> <p> <code>PT1H</code> — 1 hour </p> </li> <li> <p> <code>PT5M</code> — 5 minutes </p> </li> </ul>
startTimestring date-time required

The start time of the time range from which to list the profiles.

Response

Success

nextTokenstring

The <code>nextToken</code> value to include in a future <code>ListProfileTimes</code> request. When the results of a <code>ListProfileTimes</code> request exceed <code>maxResults</code>, this value can be used to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.