Method: projects.jobs.list

List the jobs of a project.

To list the jobs of a project in a region, we recommend using projects.locations.jobs.get 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.

HTTP request

GET https://dataflow.googleapis.com/v1b3/projects/{projectId}/jobs

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

The project which owns the jobs.

Query parameters

Parameters
filter

enum(Filter)

The kind of filter to use.

view

enum(JobView)

Level of information requested in response. Default is JOB_VIEW_SUMMARY.

pageSize

number

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

string

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

location

string

The regional endpoint that contains this job.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListJobsResponse.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/compute.readonly
  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/userinfo.email

For more information, see the Authentication Overview.

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Dataflow
Need help? Visit our support page.