Creates a new WorkerPool in a given project and location.
HTTP request
POST https://run.googleapis.com/v2/{parent}/workerPools
Path parameters
Parameters
parent
string
Required. The location and project in which this worker pool should be created. Format: projects/{project}/locations/{location}, where {project} can be project id or number. Only lowercase characters, digits, and hyphens. It takes the form projects/{project}/locations/{location}.
Authorization requires the following IAM permission on the specified resource parent:
run.workerpools.create
Query parameters
Parameters
workerPoolId
string
Required. The unique identifier for the WorkerPool. It must begin with letter, and cannot end with hyphen; must contain fewer than 50 characters. The name of the worker pool becomes {parent}/workerPools/{workerPoolId}.
validateOnly
boolean
Optional. Indicates that the request should be validated and default values populated, without persisting the request or creating any resources.
Request body
The request body contains an instance of WorkerPool.
Response body
If successful, the response body contains a newly created instance of Operation.
[[["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-08-13 UTC."],[],[],null,["# Method: projects.locations.workerPools.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\nCreates a new WorkerPool in a given project and location.\n\n### HTTP request\n\n`POST https://run.googleapis.com/v2/{parent}/workerPools`\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [WorkerPool](/run/docs/reference/rest/v2/projects.locations.workerPools#WorkerPool).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/run/docs/reference/rest/v2/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)."]]
