Kubernetes API 参考  集群 API 列表  查询所有集群实例

查看您在容器服务中创建的所有集群（包括 Swarm 和 Kubernetes 集群）。

请求信息


请求行 RequestLineGET /clusters HTTP/1.1
特有请求头 RequestHead
无，请参考 公共请求头部。
请求体 RequestBody
无

返回信息


返回行 ResponseLineH TTP/1.1 200 OK
特有返回头 ResponseHead
无，请参考 公共返回头部。
返回体 ResponseBody[{"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"}]
返回体解释
Cluster 的格式

[tr=rgb(51, 205, 229)][td]名称 类型描述agent_versionstringAgent 版本号。cluster_idString集群 ID，集群的唯一标识。createdstring集群的创建时间。external_loadbalancer_idString集群负载均衡服务的 ID。master_urlstring集群 Master 地址，您可以通过该地址连接您的集群进行相关操作。更多详细信息，参见通过 kubectl 连接 Kubernetes 集群。namestring集群名称，由您在创建集群时指定，在每个用户下唯一。network_modeString集群网络模式（VPC 网络: vpc）。region_idString集群所在地域 ID。security_group_idString安全组 ID。sizeString节点数。stateString集群状态。更多详细信息，参见 集群的生命周期。updatedstring最后更新时间。vpc_idstringVPC ID。vswitch_idstringVSwitch ID。

示例


请求示例GET /clusters HTTP/1.1<公共请求头>
返回示例HTTP/ 1.1 200 OK<公共响应头>[{ "agent_version": "0.5-e56dab3", "cluster_id": "c978ca3eaacd3409a9437db07598f1f69", "created": "2015-12-11T03:52:40Z", "external_loadbalancer_id": "1518f2b7e4c-cn-beijing-btc-a01", "master_url": "https://182.92.245.56:17589", "name": "my-python-cluster-039de960", "network_mode": "vpc", "region_id": "cn-beijing", "security_group_id": "sg-25yqjuxhz", "size": 5, "state": "running", "updated": "2015-12-15T15:01:58Z", "vpc_id": "", "vswitch_id": ""},{ "agent_version": "0.5-e56dab3", "cluster_id": "c1eb19e0093204cbb86c3a80334d2129e", "created": "2015-12-15T14:26:58Z", "external_loadbalancer_id": "151a6099de1-cn-beijing-btc-a01", "master_url": "https://182.92.245.56:11905", "name": "my-test-cluster-002b3f3d", "network_mode": "vpc", "region_id": "cn-beijing", "security_group_id": "sg-25rg2ws9f", "size": 1, "state": "running", "updated": "2015-12-15T14:43:55Z", "vpc_id": "", "vswitch_id": ""}]