To request the status of a job, we recommend using projects.locations.jobs.getMetrics with a regional endpoint. Using projects.jobs.getMetrics 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}/metrics
Return only metric data that has changed since this time. Default is to return all information about all metrics for the job.
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."],[[["This webpage details how to request the status of a job using the `projects.locations.jobs.getMetrics` method, which is preferred over `projects.jobs.getMetrics` because it supports regional endpoints."],["The HTTP request for retrieving job metrics is a `GET` request to `https://dataflow.googleapis.com/v1b3/projects/{projectId}/jobs/{jobId}/metrics`, utilizing gRPC Transcoding syntax."],["Essential path parameters include `projectId` and `jobId`, while optional query parameters like `startTime` and `location` allow for filtering results based on time and region."],["The request body must be empty, and a successful response will return a `JobMetrics` instance."],["Authorization requires one of the specified OAuth scopes: `https://www.googleapis.com/auth/compute` or `https://www.googleapis.com/auth/cloud-platform`."]]],[]]
