ClusterUpdate

ClusterUpdate describes an update to the cluster. Exactly one update can be applied to a cluster with each request, so at most one field can be provided.

JSON representation
{
  "desiredNodeVersion": string,
  "desiredMonitoringService": string,
  "desiredAddonsConfig": {
    object (AddonsConfig)
  },
  "desiredNodePoolId": string,
  "desiredImageType": string,
  "desiredDatabaseEncryption": {
    object (DatabaseEncryption)
  },
  "desiredWorkloadIdentityConfig": {
    object (WorkloadIdentityConfig)
  },
  "desiredMeshCertificates": {
    object (MeshCertificates)
  },
  "desiredShieldedNodes": {
    object (ShieldedNodes)
  },
  "desiredCostManagementConfig": {
    object (CostManagementConfig)
  },
  "desiredDnsConfig": {
    object (DNSConfig)
  },
  "desiredNodePoolAutoscaling": {
    object (NodePoolAutoscaling)
  },
  "desiredLocations": [
    string
  ],
  "desiredMasterAuthorizedNetworksConfig": {
    object (MasterAuthorizedNetworksConfig)
  },
  "desiredClusterAutoscaling": {
    object (ClusterAutoscaling)
  },
  "desiredBinaryAuthorization": {
    object (BinaryAuthorization)
  },
  "desiredLoggingService": string,
  "desiredResourceUsageExportConfig": {
    object (ResourceUsageExportConfig)
  },
  "desiredVerticalPodAutoscaling": {
    object (VerticalPodAutoscaling)
  },
  "desiredPrivateClusterConfig": {
    object (PrivateClusterConfig)
  },
  "desiredIntraNodeVisibilityConfig": {
    object (IntraNodeVisibilityConfig)
  },
  "desiredDefaultSnatStatus": {
    object (DefaultSnatStatus)
  },
  "desiredReleaseChannel": {
    object (ReleaseChannel)
  },
  "desiredL4ilbSubsettingConfig": {
    object (ILBSubsettingConfig)
  },
  "desiredDatapathProvider": enum (DatapathProvider),
  "desiredPrivateIpv6GoogleAccess": enum (PrivateIPv6GoogleAccess),
  "desiredNotificationConfig": {
    object (NotificationConfig)
  },
  "desiredAuthenticatorGroupsConfig": {
    object (AuthenticatorGroupsConfig)
  },
  "desiredLoggingConfig": {
    object (LoggingConfig)
  },
  "desiredMonitoringConfig": {
    object (MonitoringConfig)
  },
  "desiredIdentityServiceConfig": {
    object (IdentityServiceConfig)
  },
  "desiredServiceExternalIpsConfig": {
    object (ServiceExternalIPsConfig)
  },
  "desiredMasterVersion": string,
  "desiredParentProductConfig": {
    object (ParentProductConfig)
  },
  "desiredGcfsConfig": {
    object (GcfsConfig)
  },
  "desiredNodePoolAutoConfigNetworkTags": {
    object (NetworkTags)
  },
  "desiredGatewayApiConfig": {
    object (GatewayAPIConfig)
  },
  "etag": string,
  "desiredNodePoolLoggingConfig": {
    object (NodePoolLoggingConfig)
  },
  "desiredFleet": {
    object (Fleet)
  },
  "desiredStackType": enum (StackType),
  "additionalPodRangesConfig": {
    object (AdditionalPodRangesConfig)
  },
  "removedAdditionalPodRangesConfig": {
    object (AdditionalPodRangesConfig)
  },
  "enableK8sBetaApis": {
    object (K8sBetaAPIConfig)
  },
  "desiredSecurityPostureConfig": {
    object (SecurityPostureConfig)
  },
  "desiredNetworkPerformanceConfig": {
    object (ClusterNetworkPerformanceConfig)
  },
  "desiredAutopilotWorkloadPolicyConfig": {
    object (WorkloadPolicyConfig)
  },
  "desiredK8sBetaApis": {
    object (K8sBetaAPIConfig)
  },
  "desiredNodePoolAutoConfigResourceManagerTags": {
    object (ResourceManagerTags)
  },
  "desiredEnablePrivateEndpoint": boolean,
  "desiredEnableFqdnNetworkPolicy": boolean,
  "desiredInTransitEncryptionConfig": enum (InTransitEncryptionConfig)
}
Fields
desiredNodeVersion

string

The Kubernetes version to change the nodes to (typically an upgrade).

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 Kubernetes master version
desiredMonitoringService

string

The monitoring service the cluster should use to write metrics. Currently available options:

  • "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring service with a Kubernetes-native resource model
  • monitoring.googleapis.com - The legacy Cloud Monitoring service (no longer available as of GKE 1.15).
  • none - No metrics will be exported from the cluster.

If left as an empty string,monitoring.googleapis.com/kubernetes will be used for GKE 1.14+ or monitoring.googleapis.com for earlier versions.

desiredAddonsConfig

object (AddonsConfig)

Configurations for the various addons available to run in the cluster.

desiredNodePoolId

string

The node pool to be upgraded. This field is mandatory if "desiredNodeVersion", "desired_image_family" or "desiredNodePoolAutoscaling" is specified and there is more than one node pool on the cluster.

desiredImageType

string

The desired image type for the node pool. NOTE: Set the "desired_node_pool" field as well.

desiredDatabaseEncryption

object (DatabaseEncryption)

Configuration of etcd encryption.

desiredWorkloadIdentityConfig

object (WorkloadIdentityConfig)

Configuration for Workload Identity.

desiredMeshCertificates

object (MeshCertificates)

Configuration for issuance of mTLS keys and certificates to Kubernetes pods.

desiredShieldedNodes

object (ShieldedNodes)

Configuration for Shielded Nodes.

desiredCostManagementConfig

object (CostManagementConfig)

The desired configuration for the fine-grained cost management feature.

desiredDnsConfig

object (DNSConfig)

DNSConfig contains clusterDNS config for this cluster.

desiredNodePoolAutoscaling

object (NodePoolAutoscaling)

Autoscaler configuration for the node pool specified in desiredNodePoolId. If there is only one pool in the cluster and desiredNodePoolId is not provided then the change applies to that single node pool.

desiredLocations[]

string

The desired list of Google Compute Engine zones in which the cluster's nodes should be located.

This list must always include the cluster's primary zone.

Warning: changing cluster locations will update the locations of all node pools and will result in nodes being added and/or removed.

desiredMasterAuthorizedNetworksConfig

object (MasterAuthorizedNetworksConfig)

The desired configuration options for master authorized networks feature.

desiredClusterAutoscaling

object (ClusterAutoscaling)

Cluster-level autoscaling configuration.

desiredBinaryAuthorization

object (BinaryAuthorization)

The desired configuration options for the Binary Authorization feature.

desiredLoggingService

string

The logging service the cluster should use to write logs. Currently available options:

  • logging.googleapis.com/kubernetes - The Cloud Logging service with a Kubernetes-native resource model
  • logging.googleapis.com - The legacy Cloud Logging service (no longer available as of GKE 1.15).
  • none - no logs will be exported from the cluster.

If left as an empty string,logging.googleapis.com/kubernetes will be used for GKE 1.14+ or logging.googleapis.com for earlier versions.

desiredResourceUsageExportConfig

object (ResourceUsageExportConfig)

The desired configuration for exporting resource usage.

desiredVerticalPodAutoscaling

object (VerticalPodAutoscaling)

Cluster-level Vertical Pod Autoscaling configuration.

desiredPrivateClusterConfig

object (PrivateClusterConfig)

The desired private cluster configuration.

desiredIntraNodeVisibilityConfig

object (IntraNodeVisibilityConfig)

The desired config of Intra-node visibility.

desiredDefaultSnatStatus

object (DefaultSnatStatus)

The desired status of whether to disable default sNAT for this cluster.

desiredReleaseChannel

object (ReleaseChannel)

The desired release channel configuration.

desiredL4ilbSubsettingConfig

object (ILBSubsettingConfig)

The desired L4 Internal Load Balancer Subsetting configuration.

desiredDatapathProvider

enum (DatapathProvider)

The desired datapath provider for the cluster.

desiredPrivateIpv6GoogleAccess

enum (PrivateIPv6GoogleAccess)

The desired state of IPv6 connectivity to Google Services.

desiredNotificationConfig

object (NotificationConfig)

The desired notification configuration.

desiredAuthenticatorGroupsConfig

object (AuthenticatorGroupsConfig)

The desired authenticator groups config for the cluster.

desiredLoggingConfig

object (LoggingConfig)

The desired logging configuration.

desiredMonitoringConfig

object (MonitoringConfig)

The desired monitoring configuration.

desiredIdentityServiceConfig

object (IdentityServiceConfig)

The desired Identity Service component configuration.

desiredServiceExternalIpsConfig

object (ServiceExternalIPsConfig)

ServiceExternalIPsConfig specifies the config for the use of Services with ExternalIPs field.

desiredMasterVersion

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
desiredParentProductConfig

object (ParentProductConfig)

The desired parent product config for the cluster.

desiredGcfsConfig

object (GcfsConfig)

The desired GCFS config for the cluster

desiredNodePoolAutoConfigNetworkTags

object (NetworkTags)

The desired network tags that apply to all auto-provisioned node pools in autopilot clusters and node auto-provisioning enabled clusters.

desiredGatewayApiConfig

object (GatewayAPIConfig)

The desired config of Gateway API on this cluster.

etag

string

The current etag of the cluster. If an etag is provided and does not match the current etag of the cluster, update will be blocked and an ABORTED error will be returned.

desiredNodePoolLoggingConfig

object (NodePoolLoggingConfig)

The desired node pool logging configuration defaults for the cluster.

desiredFleet

object (Fleet)

The desired fleet configuration for the cluster.

desiredStackType

enum (StackType)

The desired stack type of the cluster. If a stack type is provided and does not match the current stack type of the cluster, update will attempt to change the stack type to the new type.

additionalPodRangesConfig

object (AdditionalPodRangesConfig)

The additional pod ranges to be added to the cluster. These pod ranges can be used by node pools to allocate pod IPs.

removedAdditionalPodRangesConfig

object (AdditionalPodRangesConfig)

The additional pod ranges that are to be removed from the cluster. The pod ranges specified here must have been specified earlier in the 'additionalPodRangesConfig' argument.

enableK8sBetaApis

object (K8sBetaAPIConfig)

Kubernetes open source beta apis enabled on the cluster. Only beta apis

desiredSecurityPostureConfig

object (SecurityPostureConfig)

Enable/Disable Security Posture API features for the cluster.

desiredNetworkPerformanceConfig

object (ClusterNetworkPerformanceConfig)

The desired network performance config.

desiredAutopilotWorkloadPolicyConfig

object (WorkloadPolicyConfig)

The desired workload policy configuration for the autopilot cluster.

desiredK8sBetaApis

object (K8sBetaAPIConfig)

Desired Beta APIs to be enabled for cluster.

desiredNodePoolAutoConfigResourceManagerTags

object (ResourceManagerTags)

The desired resource manager tags that apply to all auto-provisioned node pools in autopilot clusters and node auto-provisioning enabled clusters.

desiredEnablePrivateEndpoint

boolean

Enable/Disable private endpoint for the cluster's master.

desiredEnableFqdnNetworkPolicy

boolean

Enable/Disable FQDN Network Policy for the cluster.

desiredInTransitEncryptionConfig

enum (InTransitEncryptionConfig)

Specify the details of in-transit encryption.

IntraNodeVisibilityConfig

IntraNodeVisibilityConfig contains the desired config of the intra-node visibility on this cluster.

JSON representation
{
  "enabled": boolean
}
Fields
enabled

boolean

Enables intra node visibility for this cluster.

ILBSubsettingConfig

ILBSubsettingConfig contains the desired config of L4 Internal LoadBalancer subsetting on this cluster.

JSON representation
{
  "enabled": boolean
}
Fields
enabled

boolean

Enables l4 ILB subsetting for this cluster.