All Products
Search
Document Center

Container Service for Kubernetes:View all cluster instances

Last Updated:Aug 24, 2026

Queries all clusters that you have created.

Request syntax

GET /clusters

CLI:

aliyun cs GET /clusters

Response elements

Returns a JSON array. Each element represents a cluster.

Field Type Description
agent_version string The version of the node agent running on the cluster.
cluster_id string The cluster ID.
created datetime The time when the cluster was created.
external_loadbalancer_id string The ID of the external load balancer associated with the cluster.
master_url string The API server address of the cluster.
name string The cluster name.
network_mode string The network mode of the cluster.
region_id string The ID of the region where the cluster resides.
security_group_id string The ID of the security group associated with the cluster.
size numbers The number of nodes in the cluster.
state string The cluster state.
updated datetime The time when the cluster was last updated.
vpc_id string The ID of the Virtual Private Cloud (VPC) where the cluster resides.
vswitch_id string The ID of the vSwitch used by the cluster.

Sample response

[
    {
        "agent_version": "string",
        "cluster_id": "string",
        "created": "datetime",
        "external_loadbalancer_id": "string",
        "master_url": "string",
        "name": "string",
        "network_mode": "string",
        "region_id": "string",
        "security_group_id": "string",
        "size": "numbers",
        "state": "string",
        "updated": "datetime",
        "vpc_id": "string",
        "vswitch_id": "string"
    }
]