GOgoogle
projects

POST /v1/projects/{projectId}/zones/{zone}/clusters

Changed on

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.

Request

  • Base URL
    https://container.googleapis.com
  • URL
    https://container.googleapis.com/v1/projects/{projectId}/zones/{zone}/clusters
  • Auth
    • OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/cloud-platform
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/cloud-platform
    • or OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/container
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/container

Path parameters

projectIdstring required

Deprecated. The Google Developers Console project ID or project number. This field has been deprecated and replaced by the parent field.

zonestring required

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

parentstring

The parent (project and location) where the cluster will be created. Specified in the format projects/*/locations/*.

projectIdstring

Deprecated. The Google Developers Console project ID or project number. This field has been deprecated and replaced by the parent field.

zonestring

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.

Response

Successful response

detailstring

Output only. Detailed operation progress, if available.

endTimestring

Output only. The time the operation completed, in RFC3339 text format.

locationstring

Output only. The name of the Google Compute Engine zone or region in which the cluster resides.

namestring

Output only. The server-assigned ID for the operation.

operationType'TYPE_UNSPECIFIED' | 'CREATE_CLUSTER' | 'DELETE_CLUSTER' | 'UPGRADE_MASTER' | 'UPGRADE_NODES' | 'REPAIR_CLUSTER' | 'UPDATE_CLUSTER' | 'CREATE_NODE_POOL' | 'DELETE_NODE_POOL' | 'SET_NODE_POOL_MANAGEMENT' | 'AUTO_REPAIR_NODES' | 'AUTO_UPGRADE_NODES' | 'SET_LABELS' | 'SET_MASTER_AUTH' | 'SET_NODE_POOL_SIZE' | 'SET_NETWORK_POLICY' | 'SET_MAINTENANCE_POLICY' | 'RESIZE_CLUSTER' | 'FLEET_FEATURE_UPGRADE'

Output only. The operation type.

selfLinkstring

Output only. Server-defined URI for the operation. Example: https://container.googleapis.com/v1alpha1/projects/123/locations/us-central1/operations/operation-123.

startTimestring

Output only. The time the operation started, in RFC3339 text format.

status'STATUS_UNSPECIFIED' | 'PENDING' | 'RUNNING' | 'DONE' | 'ABORTING'

Output only. The current status of the operation.

statusMessagestring

Output only. If an error has occurred, a textual description of the error. Deprecated. Use the field error instead.

targetLinkstring

Output only. Server-defined URI for the target of the operation. The format of this is a URI to the resource being modified (such as a cluster, node pool, or node). For node pool repairs, there may be multiple nodes being repaired, but only one will be the target. Examples: - ## https://container.googleapis.com/v1/projects/123/locations/us-central1/clusters/my-cluster ## https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np/node/my-node

zonestring

Output only. The name of the Google Compute Engine zone in which the operation is taking place. This field is deprecated, use location instead.

Changes

  • 649eae563481Revision changes
    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/container was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/container was removed from the endpoint's security scheme Oauth2c

  • 8db854cc0363Revision changes
    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/container was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/container was removed from the endpoint's security scheme Oauth2c