- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Request the job status.
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}/locations/{location}/jobs/{jobId}/messages
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
projectId |
A project id. |
location |
The regional endpoint that contains the job specified by jobId. |
jobId |
The job to get messages about. |
Query parameters
| Parameters | |
|---|---|
minimumImportance |
Filter to only get messages with importance >= level |
pageSize |
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 |
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. |
startTime |
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 use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
endTime |
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 use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of ListJobMessagesResponse.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/computehttps://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.