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

创建弹性资源池 - CreateElasticResourcePool

功能介绍

创建弹性资源池。

调试

您可以在API Explorer中调试该接口。

授权信息

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

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

    授权项

    Action

    访问级别

    Access Level

    资源类型（*为必须）

    Resource Type (*: required)

    条件键

    Condition Key

    别名

    Alias

    依赖的授权项

    Dependencies

    dli:elasticresourcepool:create

    Write

    elasticresourcepool *

    -

    -

    -

    -

    -

    -

URI

  • URI格式

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

  • 参数说明
    表1 URI参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

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

请求消息

表2 请求参数说明

参数

是否必选

参数类型

描述

elastic_resource_pool_name

是

String

新建的弹性资源池名称，名称只能包含数字、英文字母和下划线，但不能是纯数字，且不能以下划线开头。长度限制：1~128个字符。

说明：

若名称中包含大写字母，将会自动转换为小写字母。

description

否

String

描述信息。长度限制：256个字符以内。

cidr_in_vpc

否

String

虚拟集群关联的vpc cidr。如果不填，默认值为172.16.0.0/12。

max_cu

是

Integer

最大CU大于等于该资源池下任意一个队列的最大CU之和且大于min_cu。

  • 标准版：最小值为64CUs
  • 基础版：最小值为16CUs，最大值为64CUs

min_cu

是

Integer

最小CU大于等于该资源池下所有队列最小CU之和，最小值为64。

  • 标准版：最小值为64CUs
  • 基础版：最小值为16CUs，最大值为64CUs

charging_mode

否

Integer

计费类型：默认值是1，表示按需计费。

enterprise_project_id

否

String

企业ID，不填默认为“0”。

tags

否

Array of Objects

队列的标签，使用标签标识云资源。包括“标签键”和“标签值”，具体请参考表3。

label

否

Object

弹性资源池属性字段。

如果需要购买基础版，配置该参数值为{"spec":"basic"}。

不配置该参数时默认为标准版弹性资源池。

ipv6_enable

否

boolean

是否启用IPv6。

开启IPv6后，将自动为资源池分配IPv6网段，暂不支持自定义IPv6网段。该功能一旦开启，将不能关闭。默认值：false

true：启用IPv6。

false，不开启IPv6。
表3 tags参数

参数名称

是否必选

参数类型

说明

key

是

String

标签的键。

说明：

标签的键的最大长度为128个字符，标签的键可以包含任意语种字母、数字、空格和_ . : +-@ ,但首尾不能含有空格，不能以_sys_开头。

value

是

String

标签的值。

说明：

标签值的最大长度为255个字符，标签的值可以包含任意语种字母、数字、空格和_ . : +-@ 。

响应消息

表4 响应参数说明

参数

是否必填

参数类型

描述

is_success

否

Boolean

执行请求是否成功。“true”表示请求执行成功。

message

否

String

消息内容。示例：Success to get tsdb list。

elastic_resource_pool_name

否

String

弹性资源池名称。示例：elastic_pool_0623_02"。

请求示例

创建一个弹性资源池，最大CU为684，最小CU为684。

{
  "elastic_resource_pool_name" : "elastic_pool_0623_02",
  "description" : "test",
  "cidr_in_vpc" : "172.16.0.0/14",
  "charging_mode" : "1",
  "max_cu" : 684,
  "min_cu" : 684
}

响应示例

{
  "is_success" : true,
  "message" : "Success to get tsdb list",
  "elastic_resource_pool_name" : "elastic_pool_0623_02"
}

状态码

状态码

描述

200

OK

400

用户输入参数错误，例如创建已存在的弹性资源池

403

Forbidden

错误码

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

相关文档