文档首页/数据湖探索 DLI/API参考/弹性资源池相关API/查询所有弹性资源池
更新时间：2025-12-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询所有弹性资源池

功能介绍

查询所有弹性资源池。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限及授权项说明。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    Action

    访问级别

    Access Level

    资源类型（*为必须）

    Resource Type (*: required)

    条件键

    Condition Key

    别名

    Alias

    依赖的授权项

    Dependencies

    dli:elasticresourcepool:list

    List

    elasticresourcepool *

    -

    -

    -

    -

    -

    -

URI

  • URI格式

    GET /v3/{project_id}/elastic-resource-pools

  • 参数说明
    表1 路径参数

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    项目编号，用于资源隔离。获取方式请参考获取项目ID。

    表2 Query参数

    参数

    是否必选

    参数类型

    描述

    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。

表4 elastic_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>

标识弹性资源池，目前只支持开发者标签，"label": {"billing_spec_code":"developer"}。

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

错误码

调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见错误码。