阅读730 返回首页    go 魔兽


查看所有集群实例__集群API列表_API参考_容器服务-阿里云

描述

说明:查看您在容器服务中创建的所有集群。如果传递了 name 参数,则只返回指定集群的详情。

请求信息

请求行 RequestLine

  1. GET /clusters?name={name} HTTP/1.1

请求行参数 URI Param

名称 类型 是否必须 描述
name string 集群名称

特有请求头 RequestHead

无,请参考 公共请求头部

请求体 RequestBody

返回信息

返回行 ResponseLine

  1. HTTP/1.1 200 OK

特有返回头 ResponseHead

无,请参考 公共返回头部

返回体 ResponseBody

  1. [
  2. {
  3. "agent_version": "string",
  4. "cluster_id": "string",
  5. "created": "datetime",
  6. "external_loadbalancer_id": "string",
  7. "master_url": "string",
  8. "name": "string",
  9. "network_mode": "string",
  10. "region_id": "string",
  11. "security_group_id": "string",
  12. "size": "numbers",
  13. "state": "string",
  14. "updated": "datetime",
  15. "vpc_id": "string",
  16. "vswitch_id": "string"
  17. }
  18. ]

返回体解释

Cluster 的格式

名称 类型 描述
agent_version string Agent 版本号。
cluster_id String 集群 ID,集群的唯一标识。
created string 集群的创建时间。
external_loadbalancer_id String 集群负载均衡服务的 ID。
master_url string 集群 Master 地址,您可以通过该地址连接您的集群进行相关操作。更多详细信息,参见 通过 Docker 工具连接集群
name string 集群名称,由您在创建集群时指定,在每个用户下唯一。
network_mode String 集群网络模式(经典网络: classic、VPC 网络: vpc)。
region_id String 集群所在地域 ID。更多详细信息,参见 地域
security_group_id String 安全组 ID。
size String 节点数。
state String 集群状态。更多详细信息,参见 集群的生命周期
updated string 最后更新时间。
vpc_id string VPC ID。
vswitch_id string vswitch ID。

示例

请求示例

  1. GET /clusters HTTP/1.1
  2. <公共请求头>

返回示例

  1. HTTP/1.1 200 OK
  2. <公共响应头>
  3. [
  4. {
  5. "agent_version": "0.5-e56dab3",
  6. "cluster_id": "c978ca3eaacd3409a9437db07598f1f69",
  7. "created": "2015-12-11T03:52:40Z",
  8. "external_loadbalancer_id": "1518f2b7e4c-cn-beijing-btc-a01",
  9. "master_url": "https://182.92.245.56:17589",
  10. "name": "my-python-cluster-039de960",
  11. "network_mode": "classic",
  12. "region_id": "cn-beijing",
  13. "security_group_id": "sg-25yqjuxhz",
  14. "size": 5,
  15. "state": "running",
  16. "updated": "2015-12-15T15:01:58Z",
  17. "vpc_id": "",
  18. "vswitch_id": ""
  19. },
  20. {
  21. "agent_version": "0.5-e56dab3",
  22. "cluster_id": "c1eb19e0093204cbb86c3a80334d2129e",
  23. "created": "2015-12-15T14:26:58Z",
  24. "external_loadbalancer_id": "151a6099de1-cn-beijing-btc-a01",
  25. "master_url": "https://182.92.245.56:11905",
  26. "name": "my-test-cluster-002b3f3d",
  27. "network_mode": "classic",
  28. "region_id": "cn-beijing",
  29. "security_group_id": "sg-25rg2ws9f",
  30. "size": 1,
  31. "state": "running",
  32. "updated": "2015-12-15T14:43:55Z",
  33. "vpc_id": "",
  34. "vswitch_id": ""
  35. }
  36. ]

最后更新:2016-11-23 16:03:52

  上一篇:go API 概述__API参考_容器服务-阿里云
  下一篇:go 创建集群实例__集群API列表_API参考_容器服务-阿里云