
# Lite Server服务器绑定EIP - BindDevServerPublicIP
#### 功能介绍
Lite Server服务器绑定的EIP接口用于将弹性公网IP（EIP）绑定到Lite Server服务器上。该接口适用于以下场景：当用户需要为Lite Server服务器分配一个固定的公网IP地址，以便从外部网络访问服务器时，可以通过此接口将指定的EIP绑定到服务器上。使用该接口的前提条件是Lite Server服务器已创建且处于运行状态，用户具有绑定EIP的权限，且指定的EIP已存在且未被其他资源使用。绑定操作完成后，EIP将成功绑定到Lite Server服务器上，服务器可以通过该EIP从外部网络访问。若Lite Server服务器不存在、已处于停止状态、指定的EIP不存在或已被使用，或用户无权限操作，接口将返回相应的错误信息。
#### 接口约束
仅限A3。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=BindDevServerPublicIP)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v1/{project_id}/dev-servers/{id}/publicips
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| id         | 是    | String | **参数解释**：Lite Server ID。 **约束限制**：必填。 **取值范围**：1 - 64字符。 **默认取值**：不涉及。                                                                                                   |
| project_id | 是    | String | **参数解释** ：用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制**：不涉及。 **取值范围**：1\~64个字符，只能由字母、数字和中划线组成。 **默认取值**：不涉及。 |
   
#### 请求参数
表2请求Body参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| public_ip_id | 否    | String | **参数解释**：EIP的ID。 **约束限制**：必填。 **取值范围**：1 - 64字符。 **默认取值**：不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Header参数 
| 参数           | 参数类型   | 描述     |
|:---|:---|:---|
| X-Request-Id | String | 链路追踪编号 |
   
表4响应Body参数 
| 参数         | 参数类型                                                                                                                   | 描述                   |
|:---|:---|:---|
| public_ips | Array of [ServerPublicIp] objects | **参数解释**：EIP相关信息的数组。 |
   
 表5ServerPublicIp 
| 参数      | 参数类型   | 描述                                                                                                                          |
|:---|:---|:---|
| id      | String | **参数解释**：EIP的ID。 **取值范围**：1 - 64字符。            |
| address | String | **参数解释**：EIP的IP地址。 **取值范围**：1 - 64字符，标准IPv4地址。 |
   
#### 请求示例
```
POST https://{endpoint}/v1/{project_id}/dev-servers/{id}/publicips
{
  "public_ip_id" : "8a8c7a61-5c3b-449e-9c96-9556b6b281bd"
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "public_ips" : [ {
    "id" : "5341c073-5e19-4bcc-97c4-0c6d4cc78cca",
    "address" : "127.0.0.1"
  } ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。
