开发者社区 问答 正文

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

根据集群 ID,查看集群的详细信息。

请求信息


请求行 RequestLineGET /clusters/{cluster_id} HTTP/1.1
请求行参数 URI Param

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述cluster_idstring是集群 ID
特有请求头 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 地址,您可以通过该地址连接您的集群进行相关操作。更多详细信息,参见 通过 Docker 工具连接集群。namestring集群名称,由您在创建集群时指定,在每个用户下唯一。network_modeString集群网络模式(VPC 网络: vpc)。region_idString集群所在地域 ID。更多详细信息,参见 地域。security_group_idString安全组 ID。sizeString节点数。stateString集群状态。更多详细信息,参见 集群的生命周期。updatedstring最后更新时间。vpc_idstringVPC ID。vswitch_idstringVSwitch ID。

示例


请求示例GET /clusters/C5b5e80b0b64a4bf6939d2d8fbbc5ded7 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": ""}

展开
收起
青蛙跳 2018-08-31 22:53:33 1171 分享 版权
阿里云 AI 助理回答

要根据集群ID查看集群的详细信息,您可以使用阿里云提供的API接口。以下是调用该接口的具体步骤和说明:

请求方法与URI

  • 方法: GET
  • URI: /clusters/{cluster_id}

请求参数

  • cluster_id (string, 必填): 集群的唯一标识符。

请求示例

GET /clusters/C5b5e80b0b64a4bf6939d2d8fbbc5ded7 HTTP/1.1

返回信息结构

成功响应时,您将收到包含集群详细信息的JSON数据,结构如下:

  • agent_version (string): Agent版本号。
  • cluster_id (string): 集群ID。
  • created (string): 集群创建时间。
  • external_loadbalancer_id (string): 集群负载均衡服务ID(如适用)。
  • master_url (string): 集群Master地址,用于连接集群进行操作。
  • name (string): 集群名称。
  • network_mode (string): 集群网络模式,通常为VPC。
  • region_id (string): 集群所在地域ID。
  • security_group_id (string): 安全组ID。
  • size (number): 集群节点数。
  • state (string): 集群状态,例如"running"。
  • updated (string): 集群最后更新时间。
  • vpc_id (string): VPC ID。
  • vswitch_id (string): VSwitch ID。

返回示例

{
  "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": ""
}

请确保在发起请求前,您已具备足够的权限来调用此API,并且替换{cluster_id}占位符为您实际需要查询的集群ID。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答