
# 创建包周期弹性资源池 - CreatePeriodElasticResourcePoolOrder
#### 功能介绍
该API用于创建包周期弹性资源池。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DLI/doc?api=CreatePeriodElasticResourcePoolOrder)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有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
POST /v3/{project_id}/orders/elastic-resource-pools
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                     |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 |
   
#### 请求参数
表2请求Body参数 
| 参数                         | 是否必选 | 参数类型                  | 描述                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| elastic_resource_pool_name | 是    | String                | 新建的弹性资源池名称。 名称只能包含数字、小写英文字母和下划线，但不能是纯数字，且不能以下划线开头。长度限制：1\~128个字符。                                                                                                                                                                              |
| description                | 否    | String                | 描述信息。长度限制：256个字符以内。                                                                                                                                                                                                                                                          |
| cidr_in_vpc                | 否    | String                | 弹性资源池的子网网段。 如果不填，默认值为172.16.0.0/12 最大长度：18                                                                                                                                                                      |
| max_cu                     | 是    | Integer               | 最大CU大于等于该资源池下任意一个队列的最大CU之和且大于min_cu。 - 标准版：最小值为64CUs  - 基础版：最小值为16CUs，最大值为64CUs   |
| min_cu                     | 是    | Integer               | 最小CU大于等于该资源池下所有队列最小CU之和，最小值为64。 - 标准版：最小值为64CUs  - 基础版：最小值为16CUs，最大值为64CUs             |
| enterprise_project_id      | 否    | String                | 企业项目ID，"0"表示default，即默认的企业项目。 开通了企业管理服务的用户可设置该参数绑定指定的项目。                                                                                                                                                                                        |
| auto_renew                 | 否    | Boolean               | 是否自动续费。 - true：是。  - false：否。   默认false                                            |
| charging_mode              | 是    | Integer               | 计费模式。 包周期计费模式默认取值为2。                                                                                                                                                                                                                           |
| period_type                | 是    | String                | 包周期类型，year或者month。 枚举值： - year：包年  - month：包月      |
| period_num                 | 否    | Integer               | 周期数，默认1。 缺省值：**1**                                                                                                                                                                                                                             |
| tags                       | 否    | Array of objects      | 弹性资源池标签。请参考[TmsTag]。                                                                                                                                                                                                                           |
| label                      | 否    | map\<string, string\> | 弹性资源池属性字段。 默认为标准版弹性资源池； {"spec":"basic"}标识基础版弹性资源池。 目前不支持其它属性设置。                                                                                                                 |
   
 表3tag参数说明 
| 参数    | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| key   | 是    | String | 标签名称。 |
| value | 是    | String | 标签值。  |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型    | 描述                       |
|:---|:---|:---|
| is_success | Boolean | 请求执行是否成功。"true"表示请求执行成功。 |
| message    | String  | 系统提示信息，执行成功时，信息可能为空。     |
| order_id   | String  | 订单ID。                    |
   
#### 请求示例
```
{
 "elastic_resource_pool_name": "dli_elastic_resource_test1",
 "max_cu": 128,
 "min_cu": 64,
 "charging_mode": 2,
 "period_type": "month"
}
```
#### 响应示例
**状态码： 200**
OK
```
{
"is_success": true,
"message": "",
"order_id": "xxxxxxxxxxxxxx"
}
```
#### 状态码
| 状态码 | 描述               |
|:---|:---|
| 200 | 请求成功。            |
| 400 | 用户输入参数错误，未能处理请求。 |
| 403 | 对被请求页面的访问被禁止。    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。
