
# 创建弹性资源池 - CreateElasticResourcePool
#### 功能介绍
创建弹性资源池。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DLI&api=CreateElasticResourcePool)中调试该接口。
#### 授权信息
账号具备所有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:create          | Write                                           | elasticresourcepool \*                                                 | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                      | -                                                 |
  | dli:elasticresourcepool:create          | Write                                           | -                                                                      | - [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)  - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)   | -                                      | -                                                 |
     
  
 
#### URI
- URI格式 POST /v3/{project_id}/elastic-resource-pools
  
- 参数说明
  表1URI参数说明 
  | 参数         | 是否必选 | 参数类型   | 描述                                                                                     |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 |
     
  
 
#### 请求消息
表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。   |
   
 表3tags参数 
| 参数名称  | 是否必选 | 参数类型   | 说明                                                                                                                                               |
|:---|:---|:---|:---|
| 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              |
   
#### 错误码
调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。
