
# 创建浮动IP（废弃）
#### 功能介绍
创建浮动IP。
当前API已废弃，请使用["创建浮动IP"](https://support.huaweicloud.com/api-eip/eip_openstackapi_0008.html)。
#### 接口约束
需获取可用于分配浮动IP的网络资源池。获取方式如下：使用GET /v2.0/networks?router:external=True或neutron net-external-list方式获取。
#### URI
POST /v2.1/{project_id}/os-floating-ips
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                        |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 |
   
#### 请求消息
请求参数如[表2]所示。
 表2请求参数 
| 参数        | 参数类型   | 是否必选 | 描述                              |
|:---|:---|:---|:---|
| tenant_id | String | 是    | 租户ID，在URI中指定。                   |
| pool      | String | 否    | 用于分配浮动IP的资源池的名字，如果不指定，则使用默认资源池。 |
   
#### 响应消息
响应参数如[表3]所示。
 表3响应参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                        |
|:---|:---|:---|:---|
| floating_ip | 是    | Object | floating_ip对象，参见[表4]。 |
   
 表4floating_ip对象 
| 参数          | 是否必选 | 参数类型   | 描述               |
|:---|:---|:---|:---|
| fixed_ip    | 是    | String | 私有IP地址           |
| id          | 是    | String | 浮动IP的ID，UUID格式   |
| instance_id | 是    | String | 被绑定主机的ID，UUID格式  |
| ip          | 是    | String | 浮动IP的ip地址        |
| pool        | 是    | String | 网络资源池名称，用于分配浮动IP |
   
#### 请求示例
```
POST https://{endpoint}/v2.1/e73621affb8f44e1bc01898747ca09d4/os-floating-ips
```
```
{
    "pool": "external"
}
```
#### 响应示例
```
{
  "floating_ip": {
    "id": "7aa2aa63-3097-4cfe-a2e4-596c301d3b1b",
    "pool": "external",
    "ip": "10.154.53.184",
    "fixed_ip": null,
    "instance_id": null
  }
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
