Request Parameters Response Elements Errors Examples See Also

ListTelemetryQuerySessions

Lists telemetry query sessions.

Returns a list of telemetry query sessions owned by the caller.

Request Parameters

maxResults

The maximum number of sessions to return per page.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No

nextToken

A token to retrieve the next page of results.

Type: String

Required: No

Response Elements

The following elements are returned by the service.

nextToken

A token to retrieve the next page of results, or null if there are no more results.

Type: String

sessions

The list of session summaries.

Type: Array of SessionSummary objects

Errors

For information about the errors that are common to all actions, see Common Error Types.

InternalServerException

An unexpected error occurred while processing the request.

errorCode: The error code associated with the internal error.

HTTP Status Code: 500

ThrottlingException

The request was throttled due to exceeding the allowed request rate.

retryAfterSeconds: The number of seconds to wait before retrying the request. Not always present.

HTTP Status Code: 429

ValidationException

A parameter is specified incorrectly.

errorCode: The error code associated with the validation failure.

HTTP Status Code: 400

Examples

List telemetry query sessions

The following example lists the query sessions owned by the caller. Payloads are shown as JSON; on the wire they are CBOR-encoded.

Sample Request


{
  "maxResults": 10
}

Sample Response


{
  "nextToken": "eyJvZmZzZXQiOjEwfQ==",
  "sessions": [
    {
      "createdAt": "2026-09-16T00:00:00Z",
      "lastActivityAt": "2026-09-16T00:05:00Z",
      "sessionId": "9f8c7d6e-5b4a-4c3d-9e2f-1a0b2c3d4e5f",
      "sessionName": "prod-latency-investigation"
    }
  ]
}