功能介绍

该API用于查询CDM集群详情，包含集群版本、集群节点信息、创建时间和集群状态等。

URI

• URI格式

  GET /v1.1/{project_id}/clusters/{cluster_id}

• 参数说明

  参数	是否为必选	类型	说明
  project_id	是	String	项目ID，获取方法请参见获取项目ID/账号名/AK/SK。
  cluster_id	是	String	集群ID，请参见创建集群的返回值获取。

请求

GET /v1.1/1551c7f6c808414d8e9f3c514a170f2e/clusters/bae65496-643e-47ca-84af-948672de7eeb

响应

• 响应样例

  {
    "version": "x.x.x",
    "instances": [{
      "flavor": {
        "id": "fb8fe666-6734-4b11-bc6c-43d11db3c745"
      },
      "volume": {
        "type": "LOCAL_DISK",
        "size": 100
      },
      "status": "200",
      "actions": ["REBOOTING"],
      "type": "cdm",
      "id": "635dce67-3df8-4756-b4c7-90e45e687367",
      "name": "cdm-c018",
      "isFrozen": "0",
      "config_status": "In-Sync"
    }],
    "updated": "2018-09-05T08:38:25",
    "name": "cdm-c018",
    "created": "2018-09-05T08:38:25",
    "id": "bae65496-643e-47ca-84af-948672de7eeb",
    "publicEndpoint": "49.xx.xx.10",
    "status": "200",
    "actions": ["REBOOTING"],
    "isFrozen": "0",
    "statusDetail": "Normal",
    "actionProgress": {
        
    },
    "config_status": "In-Sync"
  }

• 参数说明

  参数	是否为必选	类型	说明
  version	是	String	集群的版本信息。
  instances	是	列表数据结构	集群的节点信息，请参见instances参数说明。
  updated	是	String	集群更新时间，格式为 ISO8601：YYYY-MM-DDThh:mm:ssZ。
  name	是	String	集群名称。
  created	是	String	集群创建时间，格式为ISO8601：YYYY-MM-DDThh:mm:ssZ。
  id	是	String	集群ID。
  publicEndpoint	否	String	集群绑定的EIP。
  status	是	String	集群状态： 100：创建中。 200：正常。 300：失败。 303：创建失败。 800：冻结。 900：已关机。 910：正在关机。 920：正在开机。
  actions	否	String	集群的操作状态列表，有如下操作状态： REBOOTING：重启中。 RESTORING：恢复中。 REBOOT_FAILURE：重启失败。
  isFrozen	是	String	集群是否冻结： 0：否。 1：是。
  statusDetail	否	String	集群状态描述。
  actionProgress	否	列表数据结构	集群操作进度，请参见actionProgress参数说明。
  config_status	否	String	集群配置状态： In-Sync：配置已同步。 Applying：配置中。 Sync-Failure：配置失败。

• instances参数说明

  参数	是否为必选	类型	说明
  flavor	是	字典数据结构	节点的虚拟机规格，请参见flavor参数说明。
  volume	是	字典数据结构	节点的磁盘信息，请参见volume参数说明。
  status	是	String	节点状态： 100：创建中。 200：正常。 300：失败。 303：创建失败。 400：已删除。 800：冻结。
  actions	否	String列表	节点操作状态列表： REBOOTING：重启中。 RESTORING：恢复中。 REBOOT_FAILURE：重启失败。
  type	是	String	节点类型，只支持一种类型“cdm”。
  id	是	String	节点的虚拟机ID。
  name	是	String	节点的虚拟机名称。
  isFrozen	是	String	节点是否冻结： 0：否。 1：是。
  config_status	否	String	节点配置状态： In-Sync：配置已同步。 Applying：配置中。 Sync-Failure：配置失败。

• flavor参数说明

  参数	是否为必选	类型	说明
  id	是	String	节点虚拟机的规格ID。

• volume参数说明

  参数	是否为必选	类型	说明
  type	是	String	节点的磁盘类型，只支持本地磁盘。
  size	是	Integer	节点磁盘大小，单位G。

• actionProgress参数说明

  参数	是否为必选	类型	说明
  CREATING	否	String	创建集群进度，例如：29%。

返回值

• 正常

  200

• 异常

  返回值	说明
  400 Bad Request	请求错误，具体返回错误码请参考错误码。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源。
  500 Internal Server Error	服务内部错误。
  503 Service Unavailable	服务不可用。