Last modified March 2, 2022

'gsctl show nodepool' command reference

gsctl and the REST API are being phased out. We don't have an end-of-life date yet. However, we recommend to familiarize yourself with our Management API and the kubectl gs plugin as a future-proof replacement. We provide a migration page to help you with the transition.

The gsctl show nodepool command shows details on a node pool.


The command is called with the cluster and node pool ID as the only argument, separated by a slash.


gsctl show nodepool f01r4/op1dl

Here, f01r4 is the cluster ID and op1dl is the node pool ID.

You can also use the cluster’s name for identifying the cluster:

gsctl show nodepool "Cluster name"/op1dl



ID:                                            op1dl
Name:                                          General purpose node pool
Node instance type:                            m4.xlarge - 16 GB RAM, 4 CPUs each
Alike instances types:                         true
Availability zones:                            A
On-demand base capacity:                       0
Spot percentage above base capacity:           40
Node scaling:                                  Autoscaling between 2 and 10
Nodes desired:                                 3
Nodes in state Ready:                          3
Spot instances:                                1
CPUs:                                          12
RAM:                                           48 GB

Description of output rows:

  • ID: The node pool ID.
  • Name: Name assigned to the node pool.
  • Node instance type: The AWS EC2 instance type used for each worker node, plus the memory and CPU amount per node.
  • VM Size: The Azure VM size used for each worker node, plus the memory and CPU amount per node.
  • Alike instance types: Whether similar instance types are used within this node pool (eg if m5.xlarge is defined also m4.xlarge is possible)
  • Availability zones: The availability zone(s) assigned to this node pool, abbreviated to one letter. Note that it is not guaranteed that all shown availability zones have worker nodes at all times.
  • On-demand base capacity: Number of on-demand instances that this node pool needs to have until spot instances are used
  • Spot percentage above base capacity: Percentage of spot instances used once the on-demand base capacity is fullfilled. A number of 40 would mean that 60% will be on-demand and 40% will be spot instances.
  • Node scaling: Current scaling setting of the node pool. When the lower and upper end of the scaling range are the same number, the pool size is “Pinned” at certain number of worker nodes. Otherwise the node pool uses the Kubernetes autoscaler to set the amount of worker nodes within the configured range.
  • Nodes desired: The expected number of nodes. With auto-scaling active, this is the number determined by the autoscaler.
  • Nodes in state Ready: The current number of worker nodes which are in state Ready.
  • Spot instances: Whether spot instances are used or not.
  • Spot instances count: The current number of worker nodes using spot instances.
  • Spot instances max price: The maximum price per hour (in USD) that a single node pool VM instance can reach before it is deallocated (-1 means that the maximum price will be fixed to the on-demand price of the instance).
  • CPUs: The total number of CPU cores in this node pool.
  • RAM: The total amount of memory in this node pool.