NodePool

NodePool contains the name and configuration for a cluster's node pool. Node pools are a set of nodes (i.e. VM's), with a common configuration and specification, under the control of the cluster master. They may have a set of Kubernetes labels applied to them, which may be used to reference them during pod scheduling. They may also be resized up or down, to accommodate the workload.

Cloud-NativeContainersGoogle CloudKubernetesManaged ServiceContainer Orchestration

Properties

Name Type Description
status string Output only. The status of the nodes in this pool instance.
instanceGroupUrls array Output only. The resource URLs of the [managed instance groups](https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances) associated with this node pool. During the n
autoscaling object Autoscaler configuration for this NodePool. Autoscaler is enabled only if a valid configuration is present.
upgradeSettings object Upgrade settings control disruption and speed of the upgrade.
version string The version of Kubernetes running on this NodePool's nodes. If unspecified, it defaults as described [here](https://cloud.google.com/kubernetes-engine/versioning#specifying_node_version).
networkConfig object Networking configuration for this NodePool. If specified, it overrides the cluster-level defaults.
autopilotConfig object Specifies the autopilot configuration for this node pool. This field is exclusively reserved for Cluster Autoscaler.
maintenancePolicy object Optional. Specifies the maintenance policy for the node pool.
initialNodeCount integer The initial node count for the pool. You must ensure that your Compute Engine [resource quota](https://cloud.google.com/compute/quotas) is sufficient for this number of instances. You must also have a
maxPodsConstraint object The constraint on the maximum number of pods that can be run simultaneously on a node in the node pool.
queuedProvisioning object Specifies the configuration of queued provisioning.
selfLink string Output only. Server-defined URL for the resource.
name string The name of the node pool.
bestEffortProvisioning object Enable best effort provisioning for nodes
podIpv4CidrSize integer Output only. The pod CIDR block size per node in this node pool.
updateInfo object Output only. Update info contains relevant information during a node pool update.
locations array The list of Google Compute Engine [zones](https://cloud.google.com/compute/docs/zones#available) in which the NodePool's nodes should be located. If this value is unspecified during node pool creation
placementPolicy object Specifies the node placement policy.
etag string Output only. This checksum is computed by the server based on the value of node pool fields, and may be sent on update requests to ensure the client has an up-to-date value before proceeding.
conditions array Output only. Which conditions caused the current node pool state.
statusMessage string Output only. Deprecated. Use conditions instead. Additional information about the current status of this node pool instance, if available.
management object NodeManagement configuration for this NodePool.
nodeDrainConfig object Specifies the node drain configuration for this node pool.
config object The node configuration of the pool.
kubeletCertInfo object Output only. Contains expiry information about the kubelet certificate.
View JSON Schema on GitHub

JSON Schema

google-kubernetes-engine-node-pool-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-node-pool-schema.json",
  "title": "NodePool",
  "description": "NodePool contains the name and configuration for a cluster's node pool. Node pools are a set of nodes (i.e. VM's), with a common configuration and specification, under the control of the cluster master. They may have a set of Kubernetes labels applied to them, which may be used to reference them during pod scheduling. They may also be resized up or down, to accommodate the workload.",
  "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/NodePool",
  "type": "object",
  "properties": {
    "status": {
      "readOnly": true,
      "description": "Output only. The status of the nodes in this pool instance.",
      "type": "string",
      "enum": [
        "STATUS_UNSPECIFIED",
        "PROVISIONING",
        "RUNNING",
        "RUNNING_WITH_ERROR",
        "RECONCILING",
        "STOPPING",
        "ERROR"
      ]
    },
    "instanceGroupUrls": {
      "readOnly": true,
      "items": {
        "type": "string"
      },
      "type": "array",
      "description": "Output only. The resource URLs of the [managed instance groups](https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances) associated with this node pool. During the node pool blue-green upgrade operation, the URLs contain both blue and green resources."
    },
    "autoscaling": {
      "$ref": "#/$defs/NodePoolAutoscaling",
      "description": "Autoscaler configuration for this NodePool. Autoscaler is enabled only if a valid configuration is present."
    },
    "upgradeSettings": {
      "$ref": "#/$defs/UpgradeSettings",
      "description": "Upgrade settings control disruption and speed of the upgrade."
    },
    "version": {
      "description": "The version of Kubernetes running on this NodePool's nodes. If unspecified, it defaults as described [here](https://cloud.google.com/kubernetes-engine/versioning#specifying_node_version).",
      "type": "string"
    },
    "networkConfig": {
      "$ref": "#/$defs/NodeNetworkConfig",
      "description": "Networking configuration for this NodePool. If specified, it overrides the cluster-level defaults."
    },
    "autopilotConfig": {
      "$ref": "#/$defs/AutopilotConfig",
      "description": "Specifies the autopilot configuration for this node pool. This field is exclusively reserved for Cluster Autoscaler."
    },
    "maintenancePolicy": {
      "$ref": "#/$defs/NodePoolMaintenancePolicy",
      "description": "Optional. Specifies the maintenance policy for the node pool."
    },
    "initialNodeCount": {
      "type": "integer",
      "description": "The initial node count for the pool. You must ensure that your Compute Engine [resource quota](https://cloud.google.com/compute/quotas) is sufficient for this number of instances. You must also have available firewall and routes quota.",
      "format": "int32"
    },
    "maxPodsConstraint": {
      "$ref": "#/$defs/MaxPodsConstraint",
      "description": "The constraint on the maximum number of pods that can be run simultaneously on a node in the node pool."
    },
    "queuedProvisioning": {
      "$ref": "#/$defs/QueuedProvisioning",
      "description": "Specifies the configuration of queued provisioning."
    },
    "selfLink": {
      "description": "Output only. Server-defined URL for the resource.",
      "readOnly": true,
      "type": "string"
    },
    "name": {
      "description": "The name of the node pool.",
      "type": "string"
    },
    "bestEffortProvisioning": {
      "$ref": "#/$defs/BestEffortProvisioning",
      "description": "Enable best effort provisioning for nodes"
    },
    "podIpv4CidrSize": {
      "readOnly": true,
      "format": "int32",
      "description": "Output only. The pod CIDR block size per node in this node pool.",
      "type": "integer"
    },
    "updateInfo": {
      "$ref": "#/$defs/UpdateInfo",
      "description": "Output only. Update info contains relevant information during a node pool update."
    },
    "locations": {
      "items": {
        "type": "string"
      },
      "description": "The list of Google Compute Engine [zones](https://cloud.google.com/compute/docs/zones#available) in which the NodePool's nodes should be located. If this value is unspecified during node pool creation, the [Cluster.Locations](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters#Cluster.FIELDS.locations) value will be used, instead. Warning: changing node pool locations will result in nodes being added and/or removed.",
      "type": "array"
    },
    "placementPolicy": {
      "$ref": "#/$defs/PlacementPolicy",
      "description": "Specifies the node placement policy."
    },
    "etag": {
      "readOnly": true,
      "description": "Output only. This checksum is computed by the server based on the value of node pool fields, and may be sent on update requests to ensure the client has an up-to-date value before proceeding.",
      "type": "string"
    },
    "conditions": {
      "items": {
        "$ref": "#/$defs/StatusCondition"
      },
      "type": "array",
      "description": "Output only. Which conditions caused the current node pool state.",
      "readOnly": true
    },
    "statusMessage": {
      "readOnly": true,
      "description": "Output only. Deprecated. Use conditions instead. Additional information about the current status of this node pool instance, if available.",
      "type": "string",
      "deprecated": true
    },
    "management": {
      "$ref": "#/$defs/NodeManagement",
      "description": "NodeManagement configuration for this NodePool."
    },
    "nodeDrainConfig": {
      "$ref": "#/$defs/NodeDrainConfig",
      "description": "Specifies the node drain configuration for this node pool."
    },
    "config": {
      "$ref": "#/$defs/NodeConfig",
      "description": "The node configuration of the pool."
    },
    "kubeletCertInfo": {
      "$ref": "#/$defs/KubeletCertInfo",
      "description": "Output only. Contains expiry information about the kubelet certificate."
    }
  },
  "$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"
    },
    "AdvancedMachineFeatures": {
      "properties": {
        "threadsPerCore": {
          "type": "string",
          "format": "int64",
          "description": "The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed."
        },
        "enableNestedVirtualization": {
          "description": "Whether or not to enable nested virtualization (defaults to false).",
          "type": "boolean"
        },
        "performanceMonitoringUnit": {
          "description": "Type of Performance Monitoring Unit (PMU) requested on node pool instances. If unset, PMU will not be available to the node.",
          "enum": [
            "PERFORMANCE_MONITORING_UNIT_UNSPECIFIED",
            "ARCHITECTURAL",
            "STANDARD",
            "ENHANCED"
          ],
          "type": "string"
        }
      },
      "type": "object",
      "description": "Specifies options for controlling advanced machine features."
    },
    "AutoUpgradeOptions": {
      "description": "AutoUpgradeOptions defines the set of options for the user to control how the Auto Upgrades will proceed.",
      "type": "object",
      "properties": {
        "description": {
          "readOnly": true,
          "description": "Output only. This field is set when upgrades are about to commence with the description of the upgrade.",
          "type": "string"
        },
        "autoUpgradeStartTime": {
          "type": "string",
          "description": "Output only. This field is set when upgrades are about to commence with the approximate start time for the upgrades, in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.",
          "readOnly": true
        }
      }
    },
    "AutopilotConfig": {
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "Denotes that nodes belonging to this node pool are Autopilot nodes."
        }
      },
      "type": "object",
      "description": "AutopilotConfig contains configuration of autopilot feature for this node pool."
    },
    "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."
    },
    "BestEffortProvisioning": {
      "description": "Best effort provisioning.",
      "properties": {
        "minProvisionNodes": {
          "format": "int32",
          "description": "Minimum number of nodes to be provisioned to be considered as succeeded, and the rest of nodes will be provisioned gradually and eventually when stockout issue has been resolved.",
          "type": "integer"
        },
        "enabled": {
          "type": "boolean",
          "description": "When this is enabled, cluster/node pool creations will ignore non-fatal errors like stockout to best provision as many nodes as possible right now and eventually bring up all target number of nodes"
        }
      },
      "type": "object"
    },
    "BlueGreenInfo": {
      "type": "object",
      "properties": {
        "phase": {
          "description": "Current blue-green upgrade phase.",
          "enum": [
            "PHASE_UNSPECIFIED",
            "UPDATE_STARTED",
            "CREATING_GREEN_POOL",
            "CORDONING_BLUE_POOL",
            "DRAINING_BLUE_POOL",
            "NODE_POOL_SOAKING",
            "DELETING_BLUE_POOL",
            "ROLLBACK_STARTED"
          ],
          "type": "string"
        },
        "blueInstanceGroupUrls": {
          "type": "array",
          "description": "The resource URLs of the [managed instance groups] (/compute/docs/instance-groups/creating-groups-of-managed-instances) associated with blue pool.",
          "items": {
            "type": "string"
          }
        },
        "greenInstanceGroupUrls": {
          "type": "array",
          "description": "The resource URLs of the [managed instance groups] (/compute/docs/instance-groups/creating-groups-of-managed-instances) associated with green pool.",
          "items": {
            "type": "string"
          }
        },
        "greenPoolVersion": {
          "description": "Version of green pool.",
          "type": "string"
        },
        "bluePoolDeletionStartTime": {
          "description": "Time to start deleting blue pool to complete blue-green upgrade, in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.",
          "type": "string"
        }
      },
      "description": "Information relevant to blue-green upgrade."
    },
    "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."
    },
    "CustomImageConfig": {
      "properties": {
        "image": {
          "description": "The name of the image to use for this node.",
          "type": "string"
        },
        "imageProject": {
          "description": "The project containing the image to use for this node.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "CustomImageConfig contains the information r"
    },
    "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"
    },
    "EphemeralStorageLocalSsdConfig": {
      "description": "EphemeralStorageLocalSsdConfig contains configuration for the node ephemeral storage using Local SSDs.",
      "properties": {
        "dataCacheCount": {
          "format": "int32",
          "description": "Number of local SSDs to use for GKE Data Cache.",
          "type": "integer"
        },
        "localSsdCount": {
          "type": "integer",
          "description": "Number of local SSDs to use to back ephemeral storage. Uses NVMe interfaces. A zero (or unset) value has different meanings depending on machine type being used: 1. For pre-Gen3 machines, which support flexible numbers of local ssds, zero (or unset) means to disable using local SSDs as ephemeral storage. The limit for this value is dependent upon the maximum number of disk available on a machine per zone. See: https://cloud.google.com/compute/docs/disks/local-ssd for more information. 2. For Gen3 machines which dictate a specific number of local ssds, zero (or unset) means to use the default number of local ssds that goes with that machine type. For example, for a c3-standard-8-lssd machine, 2 local ssds would be provisioned. For c3-standard-8 (which doesn't support local ssds), 0 will be provisioned. See https://cloud.google.com/compute/docs/disks/local-ssd#choose_number_local_ssds for more info.",
          "format": "int32"
        },
        "ephemeralCapacityGb": {
          "type": "string",
          "description": "Capacity set aside for Ephemeral Storage if using mixed Local SSD modes. The remaining capacity is Raw Block.",
          "format": "int64"
        }
      },
      "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 b

# --- truncated at 32 KB (112 KB total) ---
# Full source: https://artifacts.apis.io/google-kubernetes-engine/json-schema/google-kubernetes-engine-node-pool-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-node-pool"
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.