Method: projects.zones.clusters.master

Updates the master for a specific cluster.

HTTP request

POST https://container.googleapis.com/v1beta1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/master

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

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

zone

string

Deprecated. The name of the Google Compute Engine zone in which the cluster resides. This field has been deprecated and replaced by the name field.

clusterId

string

Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field.

Request body

The request body contains data with the following structure:

JSON representation
{
  "masterVersion": string,
  "name": string
}
Fields
masterVersion

string

The Kubernetes version to change the master to.

Users may specify either explicit versions offered by Kubernetes Engine or version aliases, which have the following behavior:

  • "latest": picks the highest valid Kubernetes version
  • "1.X": picks the highest valid patch+gke.N patch in the 1.X version
  • "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
  • "1.X.Y-gke.N": picks an explicit Kubernetes version
  • "-": picks the default Kubernetes version

name

string

The name (project, location, cluster) of the cluster to update. Specified in the format 'projects/*/locations/*/clusters/*'.

Authorization requires the following Google IAM permission on the specified resource name:

  • container.clusters.update

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Was this page helpful? Let us know how we did:

Send feedback about...

Kubernetes Engine