To request the status of a job, we recommend using projects.locations.jobs.messages.list with a regional endpoint. Using projects.jobs.messages.list is not recommended, as you can only request the status of jobs that are running in us-central1.
HTTP request
GET https://dataflow.googleapis.com/v1b3/projects/{projectId}/jobs/{jobId}/messages
Filter to only get messages with importance >= level
pageSize
integer
If specified, determines the maximum number of messages to return. If unspecified, the service may choose an appropriate default, or may return an arbitrarily large number of results.
pageToken
string
If supplied, this should be the value of nextPageToken returned by an earlier call. This will cause the next page of results to be returned.
If specified, return only messages with timestamps >= startTime. The default is the job creation time (i.e. beginning of messages).
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Return only messages with timestamps < endTime. The default is now (i.e. return up to the latest messages available).
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
[[["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 get the status of a job, it's recommended to use \u003ccode\u003eprojects.locations.jobs.messages.list\u003c/code\u003e with a regional endpoint, rather than \u003ccode\u003eprojects.jobs.messages.list\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request to obtain job messages is a \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://dataflow.googleapis.com/v1b3/projects/{projectId}/jobs/{jobId}/messages\u003c/code\u003e, adhering to gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003ePath parameters \u003ccode\u003eprojectId\u003c/code\u003e and \u003ccode\u003ejobId\u003c/code\u003e are required to specify the project and job for which to retrieve messages, respectively.\u003c/p\u003e\n"],["\u003cp\u003eSeveral query parameters are available to refine the message retrieval, including \u003ccode\u003eminimumImportance\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003estartTime\u003c/code\u003e, \u003ccode\u003eendTime\u003c/code\u003e, and \u003ccode\u003elocation\u003c/code\u003e, allowing filtering and pagination of job messages.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful request will return a \u003ccode\u003eListJobMessagesResponse\u003c/code\u003e instance, while also needing authorization from 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 scopes.\u003c/p\u003e\n"]]],[],null,["# Method: projects.jobs.messages.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\nRequest the job status.\n\nTo request the status of a job, we recommend using `projects.locations.jobs.messages.list` with a [regional endpoint](https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.messages.list` is not recommended, as you can only request the status of jobs that are running in `us-central1`.\n\n### HTTP request\n\n`GET https://dataflow.googleapis.com/v1b3/projects/{projectId}/jobs/{jobId}/messages`\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 [ListJobMessagesResponse](/dataflow/docs/reference/rest/v1b3/ListJobMessagesResponse).\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)."]]
