Method: projects.locations.batches.create

Creates a batch workload that executes asynchronously.

HTTP request

POST https://dataproc.googleapis.com/v1/{parent=projects/*/locations/*}/batches

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource where this batch will be created.

Authorization requires the following IAM permission on the specified resource parent:

  • dataproc.batches.create

Query parameters

Parameters
batchId

string

Optional. The ID to use for the batch, which will become the final component of the batch's resource name.

This value must be 4-63 characters. Valid characters are /[a-z][0-9]-/.
requestId

string

Optional. A unique ID used to identify the request. If the service receives two CreateBatchRequests with the same requestId, the second request is ignored and the Operation that corresponds to the first Batch created and stored in the backend is returned.

Recommendation: Set this value to a UUID.

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

Request body

The request body contains an instance of Batch.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.