Method: projects.locations.batches.create

Stay organized with collections Save and categorize content based on your preferences.

Creates a batch workload that executes asynchronously.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



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



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]-/.



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:


For more information, see the Authentication Overview.