UpdateNodePoolRequest

UpdateNodePoolRequests update a node pool's image and/or version.

Cloud-NativeContainersGoogle CloudKubernetesManaged ServiceContainer Orchestration

Properties

Name Type Description
maxRunDuration string The maximum duration for the nodes to exist. If unspecified, the nodes can exist indefinitely.
imageType string Required. The desired image type for the node pool. Please see https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for available image types.
kubeletConfig object Node kubelet configs.
bootDisk object The desired boot disk config for nodes in the node pool. Initiates an upgrade operation that migrates the nodes in the node pool to the specified boot disk config.
loggingConfig object Logging configuration.
containerdConfig object The desired containerd config for nodes in the node pool. Initiates an upgrade operation that recreates the nodes with the new config.
flexStart boolean Flex Start flag for enabling Flex Start VM.
resourceLabels object The resource labels for the node pool to use to annotate any related Google Compute Engine resources.
taints object The desired node taints to be applied to all nodes in the node pool. If this field is not present, the taints will not be changed. Otherwise, the existing node taints will be *replaced* with the provi
gvnic object Enable or disable gvnic on the node pool.
confidentialNodes object Confidential nodes config. All the nodes in the node pool will be Confidential VM once enabled.
resourceManagerTags object Desired resource manager tag keys and values to be attached to the nodes for managing Compute Engine firewalls using Network Firewall Policies. Existing tags will be replaced with new values.
nodeConfigUpdateMode string Optional. Option to specify the rollout strategy to apply node pool configuration updates. If unspecified, standard rolling update strategy with VM recreation is used as the default behavior.
fastSocket object Enable or disable NCCL fast socket for the node pool.
windowsNodeConfig object Parameters that can be configured on Windows nodes.
storagePools array List of Storage Pools where boot disks are provisioned. Existing Storage Pools will be replaced with storage-pools.
diskSizeGb string Optional. The desired disk size for nodes in the node pool specified in GB. The smallest allowed disk size is 10GB. Initiates an upgrade operation that migrates the nodes in the node pool to the speci
accelerators array A list of hardware accelerators to be attached to each node. See https://cloud.google.com/compute/docs/gpus for more information about support for GPUs.
upgradeSettings object Upgrade settings control disruption and speed of the upgrade.
name string The name (project, location, cluster, node pool) of the node pool to update. Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`.
machineType string Optional. The desired [Google Compute Engine machine type](https://cloud.google.com/compute/docs/machine-types) for nodes in the node pool. Initiates an upgrade operation that migrates the nodes in th
nodeVersion string Required. 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 beh
nodePoolId string Deprecated. The name of the node pool to upgrade. This field has been deprecated and replaced by the name field.
imageProject string The project containing the desired image to use for this node pool. This is used to create clusters using a custom image.
linuxNodeConfig object Parameters that can be configured on Linux nodes.
labels object The desired node labels to be applied to all nodes in the node pool. If this field is not present, the labels will not be changed. Otherwise, the existing node labels will be *replaced* with the provi
maintenancePolicy object Optional. Specifies the maintenance policy for the node pool, including maintenance exclusion options.
etag string The current etag of the node pool. If an etag is provided and does not match the current etag of the node pool, update will be blocked and an ABORTED error will be returned.
consolidationDelay string Consolidation delay defines duration after which the Cluster Autoscaler can scale down underutilized nodes. If not set, nodes are scaled down by default behavior, i.e. according to the chosen autoscal
taintConfig object The taint configuration for the node pool.
nodeDrainConfig object The desired node drain configuration for nodes in the node pool.
image string The desired name of the image name to use for this node. This is used to create clusters using a custom image.
projectId string Deprecated. The Google Developers Console [project ID or project number](https://cloud.google.com/resource-manager/docs/creating-managing-projects). This field has been deprecated and replaced by the
clusterId string Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field.
tags object The desired network tags to be applied to all nodes in the node pool. If this field is not present, the tags will not be changed. Otherwise, the existing network tags will be *replaced* with the provi
nodeNetworkConfig object Node network config.
workloadMetadataConfig object The desired workload metadata config for the node pool.
gcfsConfig object GCFS config.
locations array The desired list of Google Compute Engine [zones](https://cloud.google.com/compute/docs/zones#available) in which the node pool's nodes should be located. Changing the locations for a node pool will r
zone string Deprecated. The name of the Google Compute Engine [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster resides. This field has been deprecated and replaced by the name fi
queuedProvisioning object Specifies the configuration of queued provisioning.
diskType string Optional. The desired disk type (e.g. 'pd-standard', 'pd-ssd' or 'pd-balanced') for nodes in the node pool. Initiates an upgrade operation that migrates the nodes in the node pool to the specified dis
View JSON Schema on GitHub

JSON Schema

google-kubernetes-engine-update-node-pool-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-kubernetes-engine/json-schema/google-kubernetes-engine-update-node-pool-request-schema.json",
  "title": "UpdateNodePoolRequest",
  "description": "UpdateNodePoolRequests update a node pool's image and/or version.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-kubernetes-engine-container-projects-api-openapi.yml#/components/schemas/UpdateNodePoolRequest",
  "properties": {
    "maxRunDuration": {
      "description": "The maximum duration for the nodes to exist. If unspecified, the nodes can exist indefinitely.",
      "type": "string",
      "format": "google-duration"
    },
    "imageType": {
      "type": "string",
      "description": "Required. The desired image type for the node pool. Please see https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for available image types."
    },
    "kubeletConfig": {
      "$ref": "#/$defs/NodeKubeletConfig",
      "description": "Node kubelet configs."
    },
    "bootDisk": {
      "$ref": "#/$defs/BootDisk",
      "description": "The desired boot disk config for nodes in the node pool. Initiates an upgrade operation that migrates the nodes in the node pool to the specified boot disk config."
    },
    "loggingConfig": {
      "$ref": "#/$defs/NodePoolLoggingConfig",
      "description": "Logging configuration."
    },
    "containerdConfig": {
      "$ref": "#/$defs/ContainerdConfig",
      "description": "The desired containerd config for nodes in the node pool. Initiates an upgrade operation that recreates the nodes with the new config."
    },
    "flexStart": {
      "type": "boolean",
      "description": "Flex Start flag for enabling Flex Start VM."
    },
    "resourceLabels": {
      "$ref": "#/$defs/ResourceLabels",
      "description": "The resource labels for the node pool to use to annotate any related Google Compute Engine resources."
    },
    "taints": {
      "$ref": "#/$defs/NodeTaints",
      "description": "The desired node taints to be applied to all nodes in the node pool. If this field is not present, the taints will not be changed. Otherwise, the existing node taints will be *replaced* with the provided taints."
    },
    "gvnic": {
      "$ref": "#/$defs/VirtualNIC",
      "description": "Enable or disable gvnic on the node pool."
    },
    "confidentialNodes": {
      "$ref": "#/$defs/ConfidentialNodes",
      "description": "Confidential nodes config. All the nodes in the node pool will be Confidential VM once enabled."
    },
    "resourceManagerTags": {
      "$ref": "#/$defs/ResourceManagerTags",
      "description": "Desired resource manager tag keys and values to be attached to the nodes for managing Compute Engine firewalls using Network Firewall Policies. Existing tags will be replaced with new values."
    },
    "nodeConfigUpdateMode": {
      "enum": [
        "NODE_CONFIG_UPDATE_MODE_UNSPECIFIED",
        "LIVE_UPDATE_WITHOUT_DRAIN"
      ],
      "description": "Optional. Option to specify the rollout strategy to apply node pool configuration updates. If unspecified, standard rolling update strategy with VM recreation is used as the default behavior.",
      "type": "string"
    },
    "fastSocket": {
      "$ref": "#/$defs/FastSocket",
      "description": "Enable or disable NCCL fast socket for the node pool."
    },
    "windowsNodeConfig": {
      "$ref": "#/$defs/WindowsNodeConfig",
      "description": "Parameters that can be configured on Windows nodes."
    },
    "storagePools": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of Storage Pools where boot disks are provisioned. Existing Storage Pools will be replaced with storage-pools."
    },
    "diskSizeGb": {
      "description": "Optional. The desired disk size for nodes in the node pool specified in GB. The smallest allowed disk size is 10GB. Initiates an upgrade operation that migrates the nodes in the node pool to the specified disk size.",
      "format": "int64",
      "type": "string"
    },
    "accelerators": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AcceleratorConfig"
      },
      "description": "A list of hardware accelerators to be attached to each node. See https://cloud.google.com/compute/docs/gpus for more information about support for GPUs."
    },
    "upgradeSettings": {
      "$ref": "#/$defs/UpgradeSettings",
      "description": "Upgrade settings control disruption and speed of the upgrade."
    },
    "name": {
      "type": "string",
      "description": "The name (project, location, cluster, node pool) of the node pool to update. Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`."
    },
    "machineType": {
      "description": "Optional. The desired [Google Compute Engine machine type](https://cloud.google.com/compute/docs/machine-types) for nodes in the node pool. Initiates an upgrade operation that migrates the nodes in the node pool to the specified machine type.",
      "type": "string"
    },
    "nodeVersion": {
      "type": "string",
      "description": "Required. 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"
    },
    "nodePoolId": {
      "type": "string",
      "description": "Deprecated. The name of the node pool to upgrade. This field has been deprecated and replaced by the name field.",
      "deprecated": true
    },
    "imageProject": {
      "description": "The project containing the desired image to use for this node pool. This is used to create clusters using a custom image.",
      "type": "string"
    },
    "linuxNodeConfig": {
      "$ref": "#/$defs/LinuxNodeConfig",
      "description": "Parameters that can be configured on Linux nodes."
    },
    "labels": {
      "$ref": "#/$defs/NodeLabels",
      "description": "The desired node labels to be applied to all nodes in the node pool. If this field is not present, the labels will not be changed. Otherwise, the existing node labels will be *replaced* with the provided labels."
    },
    "maintenancePolicy": {
      "$ref": "#/$defs/NodePoolMaintenancePolicy",
      "description": "Optional. Specifies the maintenance policy for the node pool, including maintenance exclusion options."
    },
    "etag": {
      "description": "The current etag of the node pool. If an etag is provided and does not match the current etag of the node pool, update will be blocked and an ABORTED error will be returned.",
      "type": "string"
    },
    "consolidationDelay": {
      "description": "Consolidation delay defines duration after which the Cluster Autoscaler can scale down underutilized nodes. If not set, nodes are scaled down by default behavior, i.e. according to the chosen autoscaling profile.",
      "type": "string",
      "format": "google-duration"
    },
    "taintConfig": {
      "$ref": "#/$defs/TaintConfig",
      "description": "The taint configuration for the node pool."
    },
    "nodeDrainConfig": {
      "$ref": "#/$defs/NodeDrainConfig",
      "description": "The desired node drain configuration for nodes in the node pool."
    },
    "image": {
      "description": "The desired name of the image name to use for this node. This is used to create clusters using a custom image.",
      "type": "string"
    },
    "projectId": {
      "type": "string",
      "description": "Deprecated. The Google Developers Console [project ID or project number](https://cloud.google.com/resource-manager/docs/creating-managing-projects). This field has been deprecated and replaced by the name field.",
      "deprecated": true
    },
    "clusterId": {
      "description": "Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field.",
      "type": "string",
      "deprecated": true
    },
    "tags": {
      "$ref": "#/$defs/NetworkTags",
      "description": "The desired network tags to be applied to all nodes in the node pool. If this field is not present, the tags will not be changed. Otherwise, the existing network tags will be *replaced* with the provided tags."
    },
    "nodeNetworkConfig": {
      "$ref": "#/$defs/NodeNetworkConfig",
      "description": "Node network config."
    },
    "workloadMetadataConfig": {
      "$ref": "#/$defs/WorkloadMetadataConfig",
      "description": "The desired workload metadata config for the node pool."
    },
    "gcfsConfig": {
      "$ref": "#/$defs/GcfsConfig",
      "description": "GCFS config."
    },
    "locations": {
      "description": "The desired list of Google Compute Engine [zones](https://cloud.google.com/compute/docs/zones#available) in which the node pool's nodes should be located. Changing the locations for a node pool will result in nodes being either created or removed from the node pool, depending on whether locations are being added or removed. Warning: It is recommended to update node pool locations in a standalone API call. Do not combine a location update with changes to other fields (such as `tags`, `labels`, `taints`, etc.) in the same request. Otherwise, the API performs a structural modification where changes to other fields will only apply to newly created nodes and will not be applied to existing nodes in the node pool. To ensure all nodes are updated consistently, use a separate API call for location changes.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "zone": {
      "type": "string",
      "description": "Deprecated. The name of the Google Compute Engine [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster resides. This field has been deprecated and replaced by the name field.",
      "deprecated": true
    },
    "queuedProvisioning": {
      "$ref": "#/$defs/QueuedProvisioning",
      "description": "Specifies the configuration of queued provisioning."
    },
    "diskType": {
      "description": "Optional. The desired disk type (e.g. 'pd-standard', 'pd-ssd' or 'pd-balanced') for nodes in the node pool. Initiates an upgrade operation that migrates the nodes in the node pool to the specified disk type.",
      "type": "string"
    }
  },
  "type": "object",
  "$defs": {
    "AcceleratorConfig": {
      "properties": {
        "acceleratorType": {
          "type": "string",
          "description": "The accelerator type resource name. List of supported accelerators [here](https://cloud.google.com/compute/docs/gpus)"
        },
        "gpuSharingConfig": {
          "$ref": "#/$defs/GPUSharingConfig",
          "description": "The configuration for GPU sharing options."
        },
        "gpuDriverInstallationConfig": {
          "$ref": "#/$defs/GPUDriverInstallationConfig",
          "description": "The configuration for auto installation of GPU driver."
        },
        "acceleratorCount": {
          "description": "The number of the accelerator cards exposed to an instance.",
          "format": "int64",
          "type": "string"
        },
        "gpuPartitionSize": {
          "description": "Size of partitions to create on the GPU. Valid values are described in the NVIDIA [mig user guide](https://docs.nvidia.com/datacenter/tesla/mig-user-guide/#partitioning).",
          "type": "string"
        }
      },
      "type": "object",
      "description": "AcceleratorConfig represents a Hardware Accelerator request."
    },
    "AccurateTimeConfig": {
      "type": "object",
      "properties": {
        "enablePtpKvmTimeSync": {
          "description": "Enables enhanced time synchronization using PTP-KVM.",
          "type": "boolean"
        }
      },
      "description": "AccurateTimeConfig contains configuration for the accurate time synchronization feature."
    },
    "AdditionalNodeNetworkConfig": {
      "properties": {
        "network": {
          "description": "Name of the VPC where the additional interface belongs",
          "type": "string"
        },
        "subnetwork": {
          "description": "Name of the subnetwork where the additional interface belongs",
          "type": "string"
        }
      },
      "type": "object",
      "description": "AdditionalNodeNetworkConfig is the configuration for additional node networks within the NodeNetworkConfig message"
    },
    "AdditionalPodNetworkConfig": {
      "properties": {
        "secondaryPodRange": {
          "type": "string",
          "description": "The name of the secondary range on the subnet which provides IP address for this pod range."
        },
        "subnetwork": {
          "type": "string",
          "description": "Name of the subnetwork where the additional pod network belongs."
        },
        "networkAttachment": {
          "description": "The name of the network attachment for pods to communicate to; cannot be specified along with subnetwork or secondary_pod_range.",
          "type": "string"
        },
        "maxPodsPerNode": {
          "$ref": "#/$defs/MaxPodsConstraint",
          "description": "The maximum number of pods per node which use this pod network."
        }
      },
      "description": "AdditionalPodNetworkConfig is the configuration for additional pod networks within the NodeNetworkConfig message",
      "type": "object"
    },
    "AutoscaledRolloutPolicy": {
      "properties": {
        "waitForDrainDuration": {
          "type": "string",
          "format": "google-duration",
          "description": "Optional. Time to wait after cordoning the blue pool before draining the nodes. Defaults to 3 days. The value can be set between 0 and 7 days, inclusive."
        }
      },
      "type": "object",
      "description": "Autoscaled rollout policy utilizes the cluster autoscaler during blue-green upgrade to scale both the blue and green pools."
    },
    "BlueGreenSettings": {
      "properties": {
        "standardRolloutPolicy": {
          "$ref": "#/$defs/StandardRolloutPolicy",
          "description": "Standard policy for the blue-green upgrade."
        },
        "nodePoolSoakDuration": {
          "type": "string",
          "format": "google-duration",
          "description": "Time needed after draining entire blue pool. After this period, blue pool will be cleaned up."
        },
        "autoscaledRolloutPolicy": {
          "$ref": "#/$defs/AutoscaledRolloutPolicy",
          "description": "Autoscaled policy for cluster autoscaler enabled blue-green upgrade."
        }
      },
      "description": "Settings for blue-green upgrade.",
      "type": "object"
    },
    "BootDisk": {
      "description": "BootDisk specifies the boot disk configuration for node pools.",
      "type": "object",
      "properties": {
        "provisionedIops": {
          "description": "For Hyperdisk-Balanced only, the provisioned IOPS config value.",
          "type": "string",
          "format": "int64"
        },
        "sizeGb": {
          "type": "string",
          "description": "Disk size in GB. Replaces NodeConfig.disk_size_gb",
          "format": "int64"
        },
        "diskType": {
          "description": "Disk type of the boot disk. (i.e. Hyperdisk-Balanced, PD-Balanced, etc.)",
          "type": "string"
        },
        "provisionedThroughput": {
          "type": "string",
          "format": "int64",
          "description": "For Hyperdisk-Balanced only, the provisioned throughput config value."
        }
      }
    },
    "BootDiskProfile": {
      "type": "object",
      "description": "Swap on the node's boot disk.",
      "properties": {
        "swapSizePercent": {
          "type": "integer",
          "format": "int32",
          "description": "Specifies the size of the swap space as a percentage of the boot disk size."
        },
        "swapSizeGib": {
          "description": "Specifies the size of the swap space in gibibytes (GiB).",
          "type": "string",
          "format": "int64"
        }
      }
    },
    "CertificateAuthorityDomainConfig": {
      "type": "object",
      "description": "CertificateAuthorityDomainConfig configures one or more fully qualified domain names (FQDN) to a specific certificate.",
      "properties": {
        "fqdns": {
          "items": {
            "type": "string"
          },
          "description": "List of fully qualified domain names (FQDN). Specifying port is supported. Wildcards are NOT supported. Examples: - `my.customdomain.com` - `10.0.1.2:5000`",
          "type": "array"
        },
        "gcpSecretManagerCertificateConfig": {
          "$ref": "#/$defs/GCPSecretManagerCertificateConfig",
          "description": "Secret Manager certificate configuration."
        }
      }
    },
    "CertificateConfig": {
      "type": "object",
      "description": "CertificateConfig configures certificate for the registry.",
      "properties": {
        "gcpSecretManagerSecretUri": {
          "description": "The URI configures a secret from [Secret Manager](https://cloud.google.com/secret-manager) in the format \"projects/$PROJECT_ID/secrets/$SECRET_NAME/versions/$VERSION\" for global secret or \"projects/$PROJECT_ID/locations/$REGION/secrets/$SECRET_NAME/versions/$VERSION\" for regional secret. Version can be fixed (e.g. \"2\") or \"latest\"",
          "type": "string"
        }
      }
    },
    "CertificateConfigPair": {
      "description": "CertificateConfigPair configures pairs of certificates, which is used for client certificate and key pairs under a registry.",
      "properties": {
        "key": {
          "$ref": "#/$defs/CertificateConfig",
          "description": "Key configures the client private key. Optional."
        },
        "cert": {
          "$ref": "#/$defs/CertificateConfig",
          "description": "Cert configures the client certificate."
        }
      },
      "type": "object"
    },
    "ConfidentialNodes": {
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "Whether Confidential Nodes feature is enabled."
        },
        "confidentialInstanceType": {
          "type": "string",
          "enum": [
            "CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED",
            "SEV",
            "SEV_SNP",
            "TDX"
          ],
          "description": "Defines the type of technology used by the confidential node."
        }
      },
      "description": "ConfidentialNodes is configuration for the confidential nodes feature, which makes nodes run on confidential VMs.",
      "type": "object"
    },
    "ContainerdConfig": {
      "type": "object",
      "properties": {
        "privateRegistryAccessConfig": {
          "$ref": "#/$defs/PrivateRegistryAccessConfig",
          "description": "PrivateRegistryAccessConfig is used to configure access configuration for private container registries."
        },
        "writableCgroups": {
          "$ref": "#/$defs/WritableCgroups",
          "description": "Optional. WritableCgroups defines writable cgroups configuration for the node pool."
        },
        "registryHosts": {
          "items": {
            "$ref": "#/$defs/RegistryHostConfig"
          },
          "type": "array",
          "description": "RegistryHostConfig configures containerd registry host configuration. Each registry_hosts represents a hosts.toml file. At most 25 registry_hosts are allowed."
        }
      },
      "description": "ContainerdConfig contains configuration to customize containerd."
    },
    "CrashLoopBackOffConfig": {
      "type": "object",
      "properties": {
        "maxContainerRestartPeriod": {
          "description": "Optional. The maximum duration the backoff delay can accrue to for container restarts, minimum 1 second, maximum 300 seconds. If not set, defaults to the internal crashloopbackoff maximum. The string must be a sequence of decimal numbers, each with optional fraction and a unit suffix, such as \"300ms\". Valid time units are \"ns\", \"us\" (or \"µs\"), \"ms\", \"s\", \"m\", \"h\". See https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#configurable-container-restart-delay for more details.",
          "type": "string"
        }
      },
      "description": "Contains config to modify node-level parameters for container restart behavior."
    },
    "CustomNodeInit": {
      "description": "Support for running custom init code while bootstrapping nodes.",
      "type": "object",
      "properties": {
        "initScript": {
          "$ref": "#/$defs/InitScript",
          "description": "Optional. The init script to be executed on the node."
        }
      }
    },
    "DedicatedLocalSsdProfile": {
      "properties": {
        "diskCount": {
          "format": "int64",
          "type": "string",
          "description": "The number of physical local NVMe SSD disks to attach."
        }
      },
      "description": "Provisions a new, separate local NVMe SSD exclusively for swap.",
      "type": "object"
    },
    "DiskIoScheduler": {
      "type": "object",
      "properties": {
        "nodeSystemIoScheduler": {
          "description": "Optional. Configures the IO scheduler for the boot disk or ephemeral lssd that runs node system workloads. Supported values are `mq-deadline`, `bfq`, `kyber`, `none`.",
          "type": "string"
        },
        "nodeAttachedDiskIoScheduler": {
          "description": "Optional. Configures the IO scheduler for the attached disks. Supported values are `mq-deadline`, `bfq`, `kyber`, `none`.",
          "type": "string"
        }
      },
      "description": "DiskIoScheduler contains the configuration for the disk IO scheduler."
    },
    "EncryptionConfig": {
      "description": "Defines encryption settings for the swap space.",
      "type": "object",
      "properties": {
        "disabled": {
          "description": "Optional. If true, swap space will not be encrypted. Defaults to false (encrypted).",
          "type": "boolean"
        }
      }
    },
    "EphemeralLocalSsdProfile": {
      "description": "Swap on the local SSD shared with pod ephemeral storage.",
      "properties": {
        "swapSizePercent": {
          "description": "Specifies the size of the swap space as a percentage of the ephemeral local SSD capacity.",
          "type": "integer",
          "format": "int32"
        },
        "swapSizeGib": {
          "format": "int64",
          "type": "string",
          "description": "Specifies the size of the swap space in gibibytes (GiB)."
        }
      },
      "type": "object"
    },
    "EtcHostsEntry": {
      "type": "object",
      "description": "Additional entries to be added to /etc/hosts.",
      "properties": {
        "host": {
          "description": "The hostname of the host.",
          "type": "string"
        },
        "ip": {
          "type": "string",
          "description": "The IPv4 or IPv6 address of the host."
        }
      }
    },
    "EvictionGracePeriod": {
      "type": "object",
      "description": "Eviction grace periods are grace periods for each eviction signal.",
      "properties": {
        "imagefsInodesFree": {
          "type": "string",
          "description": "Optional. Grace period for eviction due to imagefs inodes free signal. Sample format: \"10s\". Must be >= 0. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "nodefsInodesFree": {
          "type": "string",
          "description": "Optional. Grace period for eviction due to nodefs inodes free signal. Sample format: \"10s\". Must be >= 0. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "nodefsAvailable": {
          "type": "string",
          "description": "Optional. Grace period for eviction due to nodefs available signal. Sample format: \"10s\". Must be >= 0. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "imagefsAvailable": {
          "type": "string",
          "description": "Optional. Grace period for eviction due to imagefs available signal. Sample format: \"10s\". Must be >= 0. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "pidAvailable": {
          "description": "Optional. Grace period for eviction due to pid available signal. Sample format: \"10s\". Must be >= 0. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals",
          "type": "string"
        },
        "memoryAvailable": {
          "type": "string",
          "description": "Optional. Grace period for eviction due to memory available signal. Sample format: \"10s\". Must be >= 0. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        }
      }
    },
    "EvictionMinimumReclaim": {
      "type": "object",
      "description": "Eviction minimum reclaims are the resource amounts of minimum reclaims for each eviction signal.",
      "properties": {
        "imagefsInodesFree": {
          "description": "Optional. Minimum reclaim for eviction due to imagefs inodes free signal. Only take percentage value for now. Sample format: \"10%\". Must be <=10%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals",
          "type": "string"
        },
        "memoryAvailable": {
          "description": "Optional. Minimum reclaim for eviction due to memory available signal. Only take percentage value for now. Sample format: \"10%\". Must be <=10%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals",
          "type": "string"
        },
        "imagefsAvailable": {
          "type": "string",
          "description": "Optional. Minimum reclaim for eviction due to imagefs available signal. Only take percentage value for now. Sample format: \"10%\". Must be <=10%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "nodefsAvailable": {
          "type": "string",
          "description": "Optional. Minimum reclaim for eviction due to nodefs available signal. Only take percentage value for now. Sample format: \"10%\". Must be <=10%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "nodefsInodesFree": {
          "type": "string",
          "description": "Optional. Minimum reclaim for eviction due to nodefs inodes free signal. Only take percentage value for now. Sample format: \"10%\". Must be <=10%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "pidAvailable": {
          "description": "Optional. Minimum reclaim for eviction due to pid available signal. Only take percentage value for now. Sample format: \"10%\". Must be <=10%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals",
          "type": "string"
        }
      }
    },
    "EvictionSignals": {
      "description": "Eviction signals are the current state of a particular resource at a specific point in time. The kubelet uses eviction signals to make eviction decisions by comparing the signals to eviction thresholds, which are the minimum amount of the resource that should be available on the node.",
      "type": "object",
      "properties": {
        "pidAvailable": {
          "description": "Optional. Amount of PID available for pod allocation. Defines the amount of \"pid.available\" signal in kubelet. Default is unset, if not specified in the kubelet config. It takses percentage value for now. Sample format: \"30%\". Must be >= 10% and <= 50%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals",
          "type": "string"
        },
        "imagefsAvailable": {
          "description": "Optional. Amount of storage available on filesystem that container runtime uses for storing images layers. If the container filesystem and image filesystem are not separate, then imagefs can store both image layers and writeable layers. Defines the amount of \"imagefs.available\" signal in kubelet. Default is unset, if not specified in the kubelet config. It takses percentage value for now. Sample format: \"30%\". Must be >= 15% and <= 50%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals",
          "type": "string"
        },
        "imagefsInodesFree": {
          "type": "string",
          "description": "Optional. Amount of inodes available on filesystem that container runtime uses for storing images layers. Defines the amount of \"imagefs.inodesFree\" signal in kubelet. Default is unset, if not specified in the kubelet config. Linux only. It takses percentage value for now. Sample format: \"30%\". Must be >= 5% and <= 50%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "nodefsInodesFree": {
          "description": "Optional. Amount of inodes available on filesystem that kubelet uses for volumes, daemon logs, etc. Defines the amount of \"nodefs.inodesFree\" signal in kubelet. Default is unset, if not specified in the kubelet config. Linux only. It takses percentage value for now. Sample format: \"30%\". Must be >= 5% and <= 50%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals",
          "type": "string"
        },
        "nodefsAvailable": {
          "type": "string",
          "description": "Optional. Amount of storage available on filesystem that kubelet uses for volumes, daemon logs, etc. Defines the amount of \"nodefs.available\" signal in kubelet. Default is unset, if not specified in the kubelet config. It takses percentage value for now. Sample format: \"30%\". Must be >= 10% and <= 50%. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        },
        "memoryAvailable": {
          "type": "string",
          "description": "Optional. Memory available (i.e. capacity - workingSet), in bytes. Defines the amount of \"memory.available\" signal in kubelet. Default is unset, if not specified in the kubelet config. Format: positive number + unit, e.g. 100Ki, 10Mi, 5Gi. Valid units are Ki, Mi, Gi. Must be >= 100Mi and <= 50% of the node's memory. See https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals"
        }
      }
    },
    "ExclusionUntilEndOfSupport": {
      "description": "Defines the maintenance exclusion for the node pool.",
      "type": "object",
      "properties": {
        "startTime": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The start time of the maintenance exclusion. It is output only. It is the exclusion creation time.",
          "format": "google-datetime"
        },
        "endTime": {
          "readOnly": true,
          "format": "google-datetime",
          "description": "Output only. The end time of the maintenance exclusion. It is output only. It is the cluster control plane version's end of support time, or end of extended support time when the cluster is on extended support channel.",
          "type": "string"
        },
        "enabled": {
          "type": "boolean",
          "description": "Optional. Indicates whether the exclusion is enabled."
        }
      }
    },
    "FastSocket": {
      "description": "Configuration of Fast Socket feature.",
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "Whether Fast Socket features are enabled in the node pool."
        }
      }
    },
    "GCPSecretManagerCertificateConfig": {
      "type": "object",
      "description": "GCPSecretManagerCertificateConfig configures a secret from [Secret Manager](https://cloud.google.com/secret-manager).",
      "properties": {
        "secretUri": {
          "descr

# --- truncated at 32 KB (84 KB total) ---
# Full source: https://artifacts.apis.io/google-kubernetes-engine/json-schema/google-kubernetes-engine-update-node-pool-request-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/google-kubernetes-engine-update-node-pool-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.