# 创建边缘资源池 - CreateEdgePool
#### 功能介绍
创建边缘资源池。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/VIAS/doc?api=CreateEdgePool)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/{project_id}/edge-pools
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                           |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 用户项目ID，获取方法参见[获取项目ID和名称](https://support.huaweicloud.com/api-vias/vias_03_0283.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                     |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token，获取方法参见[认证鉴权](https://support.huaweicloud.com/api-vias/vias_03_0009.html)。 **约束限制：** 不涉及。 **取值范围：** 字符串长度\[0, 32768\]。 **默认取值：** 不涉及。 |
   
表3请求Body参数 
| 参数                      | 是否必选 | 参数类型             | 描述                                                                                                                        |
|:---|:---|:---|:---|
| name                    | 是    | String           | **参数解释：** 边缘池名称。 **约束限制：** 不涉及。 **取值范围：** 只能由小写字母（a～z）、数字（0～9）、中划线（-）组成，长度范围为\[4，32\]。需以小写字母开头，以小写字母或数字结尾。 **默认取值：** 不涉及。 |
| description             | 否    | String           | **参数解释：** 作业的描述。 **约束限制：** 不涉及。 **取值范围：** 字符串长度\[0, 255\]。 **默认取值：** 不涉及。                                                 |
| ief_service_instance_id | 否    | String           | **参数解释：** IEF的铂金版实例ID。 **约束限制：** 不涉及。 **取值范围：** 字符串长度\[0, 255\]。 **默认取值：** 不涉及。                                           |
| nodes                   | 是    | Array of strings | **参数解释：** ief边缘节点数组。 **约束限制：** 不涉及。 **取值范围：** 列表长度\[1, 10\]。 **默认取值：** 不涉及。                                               |
   
#### 响应参数
**状态码：201**
表4响应Body参数 
| 参数 | 参数类型   | 描述                                  |
|:---|:---|:---|
| id | String | **参数解释：** 创建出的边缘池ID。 **取值范围：** 不涉及。 |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型             | 描述                                        |
|:---|:---|:---|
| error_code | String           | **参数解释：** 错误码。 **取值范围：** 不涉及。             |
| error_msg  | String           | **参数解释：** 错误信息描述。 **取值范围：** 不涉及。          |
| detail     | String           | **参数解释：** 错误详情。 **取值范围：** 不涉及。            |
| params     | Array of strings | **参数解释：** 错误参数列举。 **取值范围：** 列表长度\[0, 1\]。 |
| reason     | String           | **参数解释：** 错误原因。 **取值范围：** 不涉及。            |
| advice     | String           | **参数解释：** 建议。 **取值范围：** 不涉及。              |
   
**状态码：500**
表6响应Body参数 
| 参数         | 参数类型             | 描述                                        |
|:---|:---|:---|
| error_code | String           | **参数解释：** 错误码。 **取值范围：** 不涉及。             |
| error_msg  | String           | **参数解释：** 错误信息描述。 **取值范围：** 不涉及。          |
| detail     | String           | **参数解释：** 错误详情。 **取值范围：** 不涉及。            |
| params     | Array of strings | **参数解释：** 错误参数列举。 **取值范围：** 列表长度\[0, 1\]。 |
| reason     | String           | **参数解释：** 错误原因。 **取值范围：** 不涉及。            |
| advice     | String           | **参数解释：** 建议。 **取值范围：** 不涉及。              |
   
#### 请求示例
创建name为xxx的边缘资源池，选择的节点为xxx
```
POST https://{endpoint}/v2/{project_id}/edge-pools
{
  "name":"xxx",
  "description":"xxx",
  "iefServiceInstanceId":"xxx",
  "nodes":[
    {
      "xxx"
    }
  ]
}
```
#### 响应示例
**状态码：201**
创建边缘资源池响应体。
```
{
  "id" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 201 | 创建边缘资源池响应体。 |
| 400 | 请求错误。       |
| 500 | 内部错误。       |