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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-21 UTC."],[[["\u003cp\u003eThis endpoint creates a batch workload that executes asynchronously using a POST HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to specify the resource where the batch will be created, necessitating the \u003ccode\u003edataproc.batches.create\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters include \u003ccode\u003ebatchId\u003c/code\u003e for naming the batch and \u003ccode\u003erequestId\u003c/code\u003e for request identification, with specific formatting constraints.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eBatch\u003c/code\u003e instance, and a successful request will return an \u003ccode\u003eOperation\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.batches.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a batch workload that executes asynchronously.\n\n### HTTP request\n\n`POST https://dataproc.googleapis.com/v1/{parent=projects/*/locations/*}/batches`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Batch](/dataproc-serverless/docs/reference/rest/v1/projects.locations.batches#Batch).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/dataproc-serverless/docs/reference/rest/v1/projects.locations.operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
