Creates a cluster, consisting of the specified number and type of Google Compute Engine instances.
By default, the cluster is created in the project's default network.
One firewall is added for the cluster. After cluster creation, the Kubelet creates routes for each node to allow the containers on that node to communicate with all other instances in the cluster.
Finally, an entry is added to the project's global metadata indicating which CIDR range the cluster is using.
HTTP request
POST https://container.googleapis.com/v1/projects/{projectId}/zones/{zone}/clusters
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
projectId |
Deprecated. The Google Developers Console project ID or project number. This field has been deprecated and replaced by the parent field. |
zone |
Deprecated. The name of the Google Compute Engine zone in which the cluster resides. This field has been deprecated and replaced by the parent field. |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{
"cluster": {
object ( |
Fields | |
---|---|
cluster |
Required. A cluster resource |
parent |
The parent (project and location) where the cluster will be created. Specified in the format Authorization requires the following IAM permission on the specified resource
|
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.