You can call the DescribeClusterNodes operation to query information about the nodes in a specified Container Service for Kubernetes (ACK) cluster.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request syntax

GET /clusters/ClusterId/nodes?instanceIds=String&nodepool_id=String&state=String&pageSize=String&pageNumber=String HTTP/1.1

Request parameters

Table 1. Request path parameters
Parameter Type Required Example Description
ClusterId String Yes c82e6987e2961451182edacd74faf****

The ID of the cluster.

Table 2. Request query parameters
Parameter Type Required Example Description
instanceIds String No "i-bp11xjhwkj8k966u****,i-bp1dmhc2bu5igkyq****"

Node IDs. Separate multiple node IDs with commas (,).

nodepool_id String No np****

The ID of the node pool.

state String No running

The state of nodes in the cluster. You can filter nodes by state. Valid values:

  • all: Specify nodes in all states.
  • running: Specify nodes that are running.
  • removing: Specify nodes that are being removed from the cluster.
  • initial: Specify nodes that are initializing.
  • failed: Specify nodes that failed to be created.

Default value: all.

pageSize String No 10

The number of entries to return on each page.

pageNumber String No 1

The page number of the returned page.

Response syntax

HTTP/1.1 200 OK

  "nodes" : [ {
    "creation_time" : "String",
    "error_message" : "String",
    "expired_time" : "String",
    "host_name" : "String",
    "image_id" : "String",
    "instance_charge_type" : "String",
    "instance_id" : "String",
    "instance_name" : "String",
    "instance_role" : "String",
    "instance_status" : "String",
    "instance_type" : "String",
    "instance_type_family" : "String",
    "ip_address" : [ "String" ],
    "is_aliyun_node" : Boolean,
    "node_name" : "String",
    "node_status" : "String",
    "nodepool_id" : "String",
    "source" : "String",
    "state" : "String",
    "spot_strategy" : "String"
  } ],
  "page" : {
    "page_number" : Integer,
    "page_size" : Integer,
    "total_count" : Integer

Response parameters

Table 3. Response body parameters
Parameter Type Example Description
nodes Array of node

The details of the nodes in the cluster.

creation_time String 2020-08-25T11:25:35+08:00

The time when the node was created.

error_message String error***

The error message generated when the node was created.

expired_time String 2099-12-31T23:59:00+08:00

The expiration date of the node.

host_name String iZ2vcckdmxp7u0urj2k****

The name of the host.

image_id String aliyun_2_1903_x64_20G_alibase_20200529.vhd

The ID of the system image that is used by the node.

instance_charge_type String PostPaid

The billing method of the node. Valid values:

  • PrePaid: subscription. If the value is PrePaid, make sure that you have sufficient balance or credit in your account. Otherwise, an InvalidPayMethod error is returned.
  • PostPaid: pay-as-you-go.
instance_id String i-2vcckdmxp7u0urj2****

The ID of the Elastic Compute Service (ECS) instance on which the node is created.

instance_name String worker-k8s-for-cs-c5cdf7e3938bc4f8eb0e44b21a80f****

The name of the node.

instance_role String Worker

The type of node. Valid values:

  • Master: master node.
  • Worker: worker node.
instance_status String Running

The state of the node.

instance_type String ecs.c5.xlarge

The instance type of the node.

instance_type_family String ecs.c5

The ECS instance family of the node.

ip_address Array of String

The IP address of the node.

is_aliyun_node Boolean true

Indicates whether the instance is provided by Alibaba Cloud. Valid values:

  • true: The instance is provided by Alibaba Cloud.
  • false: The instance is not provided by Alibaba Cloud.
node_name String cn-chengdu.

The name of the node. This name is the identifier of the node in the cluster.

node_status String Ready

Indicates whether the node is ready. Valid values:

  • true: The node is ready.
  • false: The node is not ready.
nodepool_id String np0794239424a84eb7a95327369d56****

The ID of the node pool.

source String ess_attach

Indicates how the nodes in the node pool are initialized. The nodes can be manually created or created by using Resource Orchestration Service (ROS).

state String running

The state of the node. Valid values:

  • pending: The nodes are being created.
  • running: The nodes are running.
  • starting: The nodes are being started.
  • stopping: The nodes are being stopped.
  • stopped: The nodes are stopped.
spot_strategy String NoSpot

Indicates whether the instance is a preemptible instance. Valid values:

  • NoSpot: a non-preemptible instance.
  • SpotWithPriceLimit: a preemptible instance with the highest hourly price.
  • SpotAsPriceGo: A preemptible instance for which the market price is automatically used as the bid price. The market price can be up to the pay-as-you-go price.
page object

The pagination details.

page_number Integer 1

The page number of the returned page.

page_size Integer 10

The number of entries returned per page.

total_count Integer 5

The total number of entries returned.


Sample requests

GET /clusters/c82e6987e2961451182edacd74faf****/nodes?instanceIds="i-bp11xjhwkj8k966u****,i-bp1dmhc2bu5igkyq****"&nodepool_id=np****&state=running&pageSize=3&pageNumber=50 HTTP/1.1

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "nodes" : [ {
    "creation_time" : "2020-08-25T11:25:35+08:00",
    "error_message" : "***",
    "expired_time" : "2099-12-31T23:59:00+08:00",
    "host_name" : "iZ2vcckdmxp7u0urj2k****",
    "image_id" : "aliyun_2_1903_x64_20G_alibase_20200529.vhd",
    "instance_charge_type" : "PostPaid",
    "instance_id" : "i-2vcckdmxp7u0urj2****",
    "instance_name" : "worker-k8s-for-cs-c5cdf7e3938bc4f8eb0e44b21a80f****",
    "instance_role" : "Worker",
    "instance_status" : "Running",
    "instance_type" : "ecs.c5.xlarge",
    "instance_type_family" : "ecs.c5",
    "ip_address" : [ "" ],
    "is_aliyun_node" : true,
    "node_name" : "cn-chengdu.",
    "node_status" : "Ready",
    "nodepool_id" : "np0794239424a84eb7a95327369d56****",
    "source" : "ess_attach",
    "state" : "running",
    "spot_strategy" : "NoSpot"
  } ],
  "page" : {
    "page_number" : 1,
    "page_size" : 10,
    "total_count" : 5

Error codes

For a list of error codes, visit the API Error Center.