- 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}/jobs/{jobId}/messages
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
projectId |
A project id. |
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). A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
endTime |
Return only messages with timestamps < endTime. The default is now (i.e. return up to the latest messages available). A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
location |
The regional endpoint that contains the job specified by jobId. |
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/compute
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.