# 获取指定集群信息（废弃）
#### 功能介绍
该API用于查询指定集群的信息，包括名称、描述以及绑定的计算资源数。
![](https://support.huaweicloud.com/api-dli/public_sys-resources/note_3.0-zh-cn.png)
当前接口已废弃，不推荐使用。
#### URI
- URI格式： GET /v2.0/{project_id}/clusters/{cluster_name}
  
- 参数说明
  表1URI参数 
  | 名称           | 是否必选 | 说明                                                                                     |
  |:---|:---|:---|
  | project_id   | 是    | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 |
  | cluster_name | 是    | 集群名称。                                                                                  |
     
  
 
#### 请求消息
无请求参数。
#### 响应消息
- 返回码 成功返回200。
  
- 响应参数
  响应参数如[表2]所示。
   表2响应参数说明 
  | 参数            | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                            |
  |:---|:---|:---|:---|
  | create_time   | 是    | Long    | 创建集群的时间。是单位为"毫秒"的时间戳。                                                                                                                                                                                         |
  | description   | 否    | String  | 集群的描述信息。                                                                                                                                                                                                      |
  | cu_count      | 是    | Integer | 与集群绑定的计算单元个数。                                                                                                                                                                                                 |
  | owner         | 是    | String  | 创建集群的用户。                                                                                                                                                                                                      |
  | cluster_name  | 是    | String  | 集群名称。                                                                                                                                                                                                         |
  | status        | 是    | String  | 具体集群状态信息可参见[表3]。                                                                                                                                      |
  | resource_mode | 是    | Integer | 集群类型。 - 0：共享集群  - 1：专属集群   |
     
   表3集群状态说明 
  | 名称         | 说明                                                                                                                    |
  |:---|:---|
  | CREATING   | 集群正在创建中，当前不可用。                                                                                                        |
  | AVAILABLE  | 集群可用。                                                                                                                 |
  | SUSPENDED  | 由于长时间未使用，集群当前处于挂起状态，可通过[创建批处理作业 - CreateSparkJob](https://support.huaweicloud.com/api-dli/dli_02_0124.html)接口，重新激活集群。 |
  | RECOVERING | 集群处于挂起恢复状态，当状态变为AVAILABLE时可再次使用。                                                                                      |
     
  
 
#### 示例
- 请求样例：
  ```
  None
  ```
  
- 成功响应样例：
  ```
  { 
      "create_time": 1508143955000, 
      "cu_count": 16, 
      "description": "test", 
      "owner": "tenant1", 
      "cluster_name": "cluster1",
      "status": "AVAILABLE",
      "resource_mode": 0
   }
  ```
  ![](https://support.huaweicloud.com/api-dli/public_sys-resources/note_3.0-zh-cn.png)
  调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，详细介绍请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。