Method: projects.locations.workerPools.create

Creates a WorkerPool.

HTTP request

POST https://cloudbuild.googleapis.com/v1/{parent=projects/*/locations/*}/workerPools

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource where this worker pool will be created. Format: projects/{project}/locations/{location}.

Authorization requires the following IAM permission on the specified resource parent:

  • cloudbuild.workerpools.create

Query parameters

Parameters
workerPoolId

string

Required. Immutable. The ID to use for the WorkerPool, which will become the final component of the resource name.

This value should be 1-63 characters, and valid characters are /[a-z][0-9]-/.

validateOnly

boolean

If set, validate the request and preview the response, but do not actually post it.

Request body

The request body contains an instance of WorkerPool.

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.