All Products
Search
Document Center

Container Service for Kubernetes:View all clusters

Last Updated:Mar 26, 2026

Queries all clusters that you have created.

Request syntax

GET /clusters

Request parameters

None.

Response elements

The response is a JSON array. Each element contains the following fields.

ParameterTypeDescription
agent_versionStringThe version of the cluster agent.
cluster_idStringThe ID of the cluster.
createdDatetimeThe time when the cluster was created.
external_loadbalancer_idStringThe ID of the load balancer that provides external access to the cluster.
master_urlStringThe endpoint URL of the cluster master.
nameStringThe name of the cluster.
network_modeStringThe network mode of the cluster.
region_idStringThe ID of the region where the cluster resides.
security_group_idStringThe ID of the security group associated with the cluster.
sizeNumberThe number of nodes in the cluster.
stateStringThe state of the cluster.
updatedDatetimeThe time when the cluster was last updated.
vpc_idStringThe ID of the virtual private cloud (VPC) in which the cluster resides.
vswitch_idStringThe ID of the vSwitch associated with the cluster.

Examples

Request

aliyun cs GET /clusters

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"
    }
]