
# 查询所有弹性资源池 - ListElasticResourcePools
#### 功能介绍
查询所有弹性资源池。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DLI&api=ListElasticResourcePools)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限及授权项说明](https://support.huaweicloud.com/api-dli/dli_02_0375.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项 Action | 访问级别 Access Level | 资源类型（\*为必须） Resource Type (\*: required) | 条件键 Condition Key                                                                                                                                                                                                                                                                                             | 别名 Alias | 依赖的授权项 Dependencies |
  |:---|:---|:---|:---|:---|:---|
  | dli:elasticresourcepool:list            | List                                            | elasticresourcepool \*                                                 | -                                                                                                                                                                                                                                                                                                                                          | -                                      | -                                                 |
  | dli:elasticresourcepool:list            | List                                            | -                                                                      | - [g:RequestTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)  - [g:TagKeys](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)   | -                                      | -                                                 |
     
  
 
#### URI
- URI格式 GET /v3/{project_id}/elastic-resource-pools
  
- 参数说明
  表1路径参数 
  | 参数         | 是否必选 | 参数类型   | 描述                                                                                     |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 |
     
  表2Query参数 
  | 参数     | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                        |
  |:---|:---|:---|:---|
  | limit  | 否    | Integer | 每页的数量。默认为100。                                                                                                                                                                                                                                                                                                                                                                                             |
  | name   | 否    | String  | 通过弹性资源池名称进行模糊匹配。                                                                                                                                                                                                                                                                                                                                                                                          |
  | offset | 否    | Integer | 偏移量。默认为0。                                                                                                                                                                                                                                                                                                                                                                                                 |
  | status | 否    | String  | 弹性资源池状态。具体参数范围如下： - AVAILABLE：可使用  - SCALING：规格变更中  - CREATING：创建中  - FAILED：已失败   |
  | tags   | 否    | String  | 查询根据标签进行过滤。                                                                                                                                                                                                                                                                                                                                                                                               |
     
  
 
#### 请求消息
无。
#### 响应消息
表3响应参数说明 
| 参数                     | 是否必选 | 参数类型             | 描述                                                 |
|:---|:---|:---|:---|
| is_success             | 否    | Boolean          | 执行请求是否成功。"true"表示请求执行成功。                           |
| message                | 否    | String           | 系统提示信息，执行成功时，信息可能为空。                               |
| count                  | 否    | Long             | 总共条数。                                              |
| elastic_resource_pools | 否    | Array of Objects | 弹性资源池信息。详细请参考[表4]。 |
   
 表4elastic_resource_pools参数说明 
| 参数名称                       | 是否必选 | 参数类型                  | 说明                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| owner                      | 否    | String                | 创建弹性资源池的账号。                                                                                                                                                                                                                                                                                                                                                                              |
| elastic_resource_pool_name | 否    | String                | 弹性资源池名称。                                                                                                                                                                                                                                                                                                                                                                                 |
| description                | 否    | String                | 弹性资源池描述信息。                                                                                                                                                                                                                                                                                                                                                                               |
| max_cu                     | 否    | Integer               | 配置的最大CU数。                                                                                                                                                                                                                                                                                                                                                                                |
| min_cu                     | 否    | Integer               | 配置的最小CU数。                                                                                                                                                                                                                                                                                                                                                                                |
| actual_cu                  | 否    | Integer               | 当前实际的CU数。                                                                                                                                                                                                                                                                                                                                                                                |
| cidr_in_vpc                | 否    | String                | 弹性资源池的子网信息。                                                                                                                                                                                                                                                                                                                                                                              |
| create_time                | 否    | Long                  | 弹性资源池创建时间。                                                                                                                                                                                                                                                                                                                                                                               |
| update_time                | 否    | Long                  | 弹性资源池更新时间。                                                                                                                                                                                                                                                                                                                                                                               |
| current_cu                 | 否    | Integer               | 当前CU数量。                                                                                                                                                                                                                                                                                                                                                                                  |
| status                     | 否    | String                | 弹性资源池状态。具体参数范围如下： - AVAILABLE：可使用  - SCALING：规格变更中  - CREATING：创建中  - FAILED：已失败   |
| resource_id                | 否    | String                | 弹性资源池的资源ID。                                                                                                                                                                                                                                                                                                                                                                              |
| fail_reason                | 否    | String                | 弹性资源池创建失败原因。                                                                                                                                                                                                                                                                                                                                                                             |
| enterprise_project_id      | 否    | String                | 企业项目ID。                                                                                                                                                                                                                                                                                                                                                                                  |
| prepay_cu                  | 否    | Integer               | 预付费CU数量。                                                                                                                                                                                                                                                                                                                                                                                 |
| charging_mode              | 否    | Integer               | 计费类型。                                                                                                                                                                                                                                                                                                                                                                                    |
| queues                     | 否    | Array of Strings      | 弹性资源池所属的队列信息。                                                                                                                                                                                                                                                                                                                                                                            |
| manager                    | 否    | String                | 弹性资源池类型。                                                                                                                                                                                                                                                                                                                                                                                 |
| label                      | 否    | Map\<string, string\> | 标识弹性资源池类型。                                                                                                                                                                                                                                                                                                                                                                               |
| ipv6_enable                | 否    | boolean               | 是否启用IPv6。 - true：启用IPv6。  - false：不开启IPv6。                                                                                                                                              |
| ipv6_cidr_in_subnet        | 否    | String                | IPv6子网网段。                                                                                                                                                                                                                                                                                                                                                                                |
| id                         | 否    | Long                  | 弹性资源池ID。                                                                                                                                                                                                                                                                                                                                                                                 |
   
#### 请求示例
无
#### 响应示例
```
{
  "is_success": true,
  "message": "",
  "count": 2,
  "elastic_resource_pools": [
    {
      "owner": "ei_dlics_d00352221",
      "id": 1026,
      "elastic_resource_pool_name": "elastic_pool_0622_10",
      "description": "",
      "max_cu": 0,
      "min_cu": 0,
      "actual_cu": 0,
      "cidr_in_vpc": "172.16.0.0/12",
      "create_time": 1624366266826,
      "current_cu": 64,
      "status": "AVAILABLE",
      "resource_id": "ecc98d89-3fd1-4dec-b572-aa6e2ef82391",
      "fail_reason": "",
      "enterprise_project_id": "0",
      "prepay_cu": 0,
      "charging_mode": 1
    },
    {
      "owner": "ei_dlics_d00352221",
      "id": 1002,
      "elastic_resource_pool_name": "elastic_pool_0622_0",
      "description": "test",
      "max_cu": 684,
      "min_cu": 0,
      "actual_cu": 0,
      "cidr_in_vpc": "172.16.0.0/12",
      "create_time": 1624353878084,
      "status": "AVAILABLE",
      "resource_id": "ecc98d89-3fd1-4dec-b572-aa6e2ef82391",
      "fail_reason": "",
      "enterprise_project_id": "0",
      "prepay_cu": 0,
      "charging_mode": 1
    }
  ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。
