Required. The parent cluster where this node pool will be created.
Authorization requires the following IAM permission on the specified resource parent:
edgecontainer.nodePools.create
Query parameters
Parameters
nodePoolId
string
Required. A client-specified unique identifier for the node pool.
requestId
string
A unique identifier for this request. Restricted to 36 ASCII characters. A random UUID is recommended. This request is only idempotent if requestId is provided.
Request body
The request body contains an instance of NodePool.
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-07-11 UTC."],[[["\u003cp\u003eThis endpoint creates a new NodePool within a specified cluster, requiring the \u003ccode\u003eedgecontainer.nodePools.create\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL uses gRPC Transcoding syntax and requires a \u003ccode\u003eparent\u003c/code\u003e path parameter to define the cluster location.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003enodePoolId\u003c/code\u003e query parameter is mandatory, serving as a unique identifier for the new node pool, while \u003ccode\u003erequestId\u003c/code\u003e enables idempotency.\u003c/p\u003e\n"],["\u003cp\u003eThe request body expects a \u003ccode\u003eNodePool\u003c/code\u003e instance, and a successful operation returns an \u003ccode\u003eOperation\u003c/code\u003e instance in the response body.\u003c/p\u003e\n"],["\u003cp\u003eCreating a NodePool requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.clusters.nodePools.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 new NodePool in a given project and location.\n\n### HTTP request\n\n`POST https://edgecontainer.googleapis.com/v1/{parent=projects/*/locations/*/clusters/*}/nodePools`\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 [NodePool](/distributed-cloud/edge/1.7.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#NodePool).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/distributed-cloud/edge/1.7.0/docs/reference/container/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](https://cloud.google.com/docs/authentication/)."]]
