list method

Future<ListJobsResponse> list(
  1. String projectId,
  2. String location, {
  3. String? filter,
  4. int? pageSize,
  5. String? pageToken,
  6. String? view,
  7. String? $fields,
})

List the jobs of a project.

To list the jobs of a project in a region, we recommend using projects.locations.jobs.list with a regional endpoint. To list the all jobs across all regions, use projects.jobs.aggregated. Using projects.jobs.list is not recommended, as you can only get the list of jobs that are running in us-central1.

Request parameters:

projectId - The project which owns the jobs.

location - The regional endpoint that contains this job.

filter - The kind of filter to use. Possible string values are:

  • "UNKNOWN" : The filter isn't specified, or is unknown. This returns all jobs ordered on descending JobUuid.
  • "ALL" : Returns all running jobs first ordered on creation timestamp, then returns all terminated jobs ordered on the termination timestamp.
  • "TERMINATED" : Filters the jobs that have a terminated state, ordered on the termination timestamp. Example terminated states: JOB_STATE_STOPPED, JOB_STATE_UPDATED, JOB_STATE_DRAINED, etc.
  • "ACTIVE" : Filters the jobs that are running ordered on the creation timestamp.

pageSize - If there are many jobs, limit response to at most this many. The actual number of jobs returned will be the lesser of max_responses and an unspecified server-defined limit.

pageToken - Set this to the 'next_page_token' field of a previous response to request additional results in a long list.

view - Deprecated. ListJobs always returns summaries now. Use GetJob for other JobViews. Possible string values are:

  • "JOB_VIEW_UNKNOWN" : The job view to return isn't specified, or is unknown. Responses will contain at least the JOB_VIEW_SUMMARY information, and may contain additional information.
  • "JOB_VIEW_SUMMARY" : Request summary information only: Project ID, Job ID, job name, job type, job status, start/end time, and Cloud SDK version details.
  • "JOB_VIEW_ALL" : Request all information available for this job.
  • "JOB_VIEW_DESCRIPTION" : Request summary info and limited job description data for steps, labels and environment.

$fields - Selector specifying which fields to include in a partial response.

Completes with a ListJobsResponse.

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<ListJobsResponse> list(
  core.String projectId,
  core.String location, {
  core.String? filter,
  core.int? pageSize,
  core.String? pageToken,
  core.String? view,
  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 (view != null) 'view': [view],
    if ($fields != null) 'fields': [$fields],
  };

  final _url = 'v1b3/projects/' +
      commons.escapeVariable('$projectId') +
      '/locations/' +
      commons.escapeVariable('$location') +
      '/jobs';

  final _response = await _requester.request(
    _url,
    'GET',
    queryParams: _queryParams,
  );
  return ListJobsResponse.fromJson(
      _response as core.Map<core.String, core.dynamic>);
}