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, because you can only get the list of jobs that are running in us-central1.
projects.locations.jobs.list and projects.jobs.list support filtering the list of jobs by name. Filtering by name isn't supported by projects.jobs.aggregated.
HTTP request
GET https://dataflow.googleapis.com/v1b3/projects/{projectId}/jobs
Deprecated. jobs.list always returns summaries now. Use jobs.get for other JobViews.
pageSize
integer
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-30 UTC."],[[["\u003cp\u003eTo list jobs within a specific region, utilize the \u003ccode\u003eprojects.locations.jobs.list\u003c/code\u003e method with a regional endpoint.\u003c/p\u003e\n"],["\u003cp\u003eFor a comprehensive list of all jobs across all regions, employ the \u003ccode\u003eprojects.jobs.aggregated\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eprojects.locations.jobs.list\u003c/code\u003e and \u003ccode\u003eprojects.jobs.list\u003c/code\u003e methods allow filtering of jobs by name, but this functionality is not available with \u003ccode\u003eprojects.jobs.aggregated\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGET https://dataflow.googleapis.com/v1b3/projects/{projectId}/jobs\u003c/code\u003e request method allows you to view a list of jobs.\u003c/p\u003e\n"],["\u003cp\u003eThe request to list jobs requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/compute\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: projects.jobs.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList the jobs of a project.\n\nTo list the jobs of a project in a region, we recommend using `projects.locations.jobs.list` with a [regional endpoint](https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To list the all jobs across all regions, use `projects.jobs.aggregated`. Using `projects.jobs.list` is not recommended, because you can only get the list of jobs that are running in `us-central1`.\n\n`projects.locations.jobs.list` and `projects.jobs.list` support filtering the list of jobs by name. Filtering by name isn't supported by `projects.jobs.aggregated`.\n\n### HTTP request\n\n`GET https://dataflow.googleapis.com/v1b3/projects/{projectId}/jobs`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListJobsResponse](/dataflow/docs/reference/rest/v1b3/ListJobsResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/compute`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
