list method
Lists interactive sessions.
Request parameters:
parent
- Required. The parent, which owns this collection of sessions.
Value must have pattern ^projects/\[^/\]+/locations/\[^/\]+$
.
filter
- Optional. A filter for the sessions to return in the response.A
filter is a logical expression constraining the values of various fields
in each session resource. Filters are case sensitive, and may contain
multiple clauses combined with logical operators (AND, OR). Supported
fields are session_id, session_uuid, state, create_time, and
labels.Example: state = ACTIVE and create_time < "2023-01-01T00:00:00Z"
is a filter for sessions in an ACTIVE state that were created before
2023-01-01. state = ACTIVE and labels.environment=production is a filter
for sessions in an ACTIVE state that have a production environment
label.See https://google.aip.dev/assets/misc/ebnf-filtering.txt for a
detailed description of the filter syntax and a list of supported
comparators.
pageSize
- Optional. The maximum number of sessions to return in each
response. The service may return fewer than this value.
pageToken
- Optional. A page token received from a previous ListSessions
call. Provide this token to retrieve the subsequent page.
$fields
- Selector specifying which fields to include in a partial
response.
Completes with a ListSessionsResponse.
Completes with a commons.ApiRequestError if the API endpoint returned an error.
If the used http.Client
completes with an error when making a REST call,
this method will complete with the same error.
Implementation
async.Future<ListSessionsResponse> list(
core.String parent, {
core.String? filter,
core.int? pageSize,
core.String? pageToken,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (filter != null) 'filter': [filter],
if (pageSize != null) 'pageSize': ['${pageSize}'],
if (pageToken != null) 'pageToken': [pageToken],
if ($fields != null) 'fields': [$fields],
};
final url_ = 'v1/' + core.Uri.encodeFull('$parent') + '/sessions';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return ListSessionsResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>);
}