You can call DescribeClusterNodes to query nodes in a 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 parameter types

This operation uses only common request parameters. For more information, see Common parameters.

Request syntax

get /clusters/{ClusterId}/nodes http|https

Request parameters

Parameter Type Required Example Description
ClusterId String Yes c82e6987e2961451182edacd74faf****

The ID of the cluster.

pageSize String No 3

The number of entries to return on each page.

pageNumber String No 50

The total number of pages to return.

nodepool_id String No np***

The ID of the node pool.

state String No all

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

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

Response parameters

Parameter Type Example Description
nodes Array of node

A list of nodes.

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

The time when the node was created.

error_message String "***"

The error message about the node.

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

The expiration time 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 used by the node.

instance_charge_type String "PostPaid"

The billing method of the node.

instance_id String "i-2vcckdmxp7u0urj2k2rw"

The ID of the ECS instance.

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

The name of the ECS instance.

instance_role String "Worker"

The role of the node. Valid values:

  • Master
  • Worker
instance_status String "Running"

The status of the ECS instance.

instance_type String "ecs.c5.xlarge"

The ECS 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 node is provided by Alibaba Cloud.

node_name String "cn-chengdu."

The name of the node in the cluster.

node_status String "Ready"

The status of the node in the cluster.

nodepool_id String "np0794239424a84eb7a95327369d56****"

The ID of the node pool.

source String "ess_attach"

The source of the node. You can add a node to a cluster in the Container Service for Kubernetes (ACK) console or Resource Orchestration Service (ROS) console.

state String "running"

The status of the ECS instance.

page Object

The pagination details.

page_number Integer "1"

The total number of pages returned.

page_size Integer "10"

The number of entries returned on each page.

total_count Integer "5"

The total number of entries returned.


Sample requests

GET /clusters/[ClusterId]/nodes HTTP/1.1
Common request parameters
    "ClusterId":" c82e6987e2961451182edacd74faf****"

Sample success responses

XML format


JSON format

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

Error codes

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