- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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 |
Required. The parent resource where this batch will be created. Authorization requires the following IAM permission on the specified resource
|
Query parameters
Parameters | |
---|---|
batchId |
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 |
requestId |
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.