Method: projects.regions.jobs.submit

Submits a job to a cluster.

HTTP request

POST https://dataproc.googleapis.com/v1/projects/{projectId}/regions/{region}/jobs:submit

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. The ID of the Google Cloud Platform project that the job belongs to.

Authorization requires one or more of the following Google IAM permissions on the specified resource projectId:

  • dataproc.jobs.create
  • dataproc.clusters.use

region

string

Required. The Cloud Dataproc region in which to handle the request.

Request body

The request body contains data with the following structure:

JSON representation
{
  "job": {
    object(Job)
  },
  "requestId": string
}
Fields
job

object(Job)

Required. The job resource.

requestId

string

Optional. A unique id used to identify the request. If the server receives two SubmitJobRequest requests with the same id, then the second request will be ignored and the first Job created and stored in the backend is returned.

It is recommended to always set this value to a UUID.

The id must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.

Response body

If successful, the response body contains an instance of Job.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Try it!

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Dataproc