# 更新弹性公网IP - UpdatePublicip
#### 功能介绍
更新弹性公网IP信息，将弹性公网IP跟一个网卡绑定或者解绑定，转换IP地址版本类型。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/EIP/doc?api=UpdatePublicip&version=v2)中调试该接口，支持自动认证鉴权。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-eip/eip_apipermission_0000.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                  | 访问级别  | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 别名                   | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | eip:publicIps:update | Write | publicip \* | - g:EnterpriseProjectId   - g:ResourceTag/\<tag-key\>    | vpc:publicIps:update | -      |
     
  
 
#### URI
PUT /v1/{project_id}/publicips/{publicip_id}
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| project_id  | 是    | String | **参数解释：** 项目ID [参见获取项目ID](https://support.huaweicloud.com/api-eip/eip_api06_0004.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| publicip_id | 是    | String | **参数解释：** 弹性公网IP唯一标识。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不超过36个字符。                                                              |
   
#### 请求参数
表2请求Body参数 
| 参数       | 是否必选 | 参数类型                                                                                                    | 描述       |
|:---|:---|:---|:---|
| publicip | 是    | [UpdatePublicipOption] object | 弹性公网IP对象 |
   
 表3UpdatePublicipOption 
| 参数         | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| port_id    | 否    | String  | **参数解释：** 端口id。 **约束限制：** - 必须是存在的端口id，如果该参数值为空时为解除绑定弹性公网IP，如果该端口不存在或端口已绑定弹性公网IP则会提示出错。   - 和ip_version字段互斥，不能同时更新。    **取值范围：** 最大长度36。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ip_version | 否    | Integer | **参数解释：** IP版本信息。 **约束限制：** - 必须是系统支持的IP版本类型。   - 和port_id互斥，不能同时更新。   - 4：IPv4。   - 6：IPv6，开启NAT64能力。    **取值范围：** **默认取值：** 不涉及。 |
| alias      | 否    | String  | **参数解释：** 弹性公网IP名称。 **约束限制：** 不涉及。 **取值范围：** 1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点） **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数       | 参数类型                                                                                                 | 描述            |
|:---|:---|:---|
| publicip | [PublicipUpdateResp] object | 更新弹性公网IP的返回对象 |
   
 表5PublicipUpdateResp 
| 参数                    | 参数类型                                                                                   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| bandwidth_id          | String                                                                                 | **参数解释：** 弹性公网IP对应带宽ID。 **取值范围：** 最大长度36。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| bandwidth_name        | String                                                                                 | **参数解释：** 带宽名称。 **取值范围：** 1-64个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| bandwidth_share_type  | String                                                                                 | **参数解释：** 弹性公网IP的带宽类型 其中IPv6暂不支持WHOLE类型带宽。 **取值范围：** - WHOLE：共享带宽。   - PER：独享带宽。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| bandwidth_size        | Integer                                                                                | **参数解释：** 带宽大小，单位为Mbit/s。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| create_time           | String                                                                                 | **参数解释：** 弹性公网IP申请时间，采用UTC时间。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| enterprise_project_id | String                                                                                 | **参数解释：** 企业项目ID。最大长度36字节，带"-"连字符的UUID格式，或者是字符串"0"。 关于企业项目ID的获取及企业项目特性的详细信息，请参见[《企业管理用户指南》](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0126101490.html)。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| id                    | String                                                                                 | **参数解释：** 弹性公网IP唯一标识。 **取值范围：** 最大长度36。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| port_id               | String                                                                                 | **参数解释：** 端口id。只有绑定了的弹性公网IP查询才会返回该参数。 **取值范围：** 最大长度36。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| private_ip_address    | String                                                                                 | **参数解释：** 绑定弹性公网IP的私有IP地址。只有绑定了的弹性公网IP查询才会返回该参数。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| profile               | [ProfileResp] object | **参数解释：** 额外参数，包括订单id、产品id等信息。如果profile不为空，说明是包周期的弹性公网IP                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| public_ip_address     | String                                                                                 | **参数解释：** IPv4时是申请到的弹性公网IP地址，IPv6时是IPv6地址对应的IPv4地址。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| status                | String                                                                                 | **参数解释：** 弹性公网IP的状态。 **取值范围：** - FREEZED：冻结。   - BIND_ERROR：绑定失败。   - BINDING：绑定中。   - PENDING_DELETE：释放中。   - PENDING_CREATE：创建中。   - NOTIFYING：创建中。   - NOTIFY_DELETE：释放中。   - PENDING_UPDATE：更新中。   - DOWN：未绑定。   - ACTIVE：绑定。   - ELB：绑定ELB。   - VPN：绑定VPN。   - ERROR：失败。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| tenant_id             | String                                                                                 | **参数解释：** 。 项目ID，如何获取项目ID请参见[获取项目ID](https://support.huaweicloud.com/api-vpc/vpc_api_0011.html) **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| type                  | String                                                                                 | **参数解释：** 弹性公网IP的类型。 **取值范围：** 5_bgp (全动态BGP)，5_sbgp (静态BGP)，5_bgp-premium(精品BGP) - 华南-广州：5_bgp、5_sbgp   - 华东-上海一：5_bgp、5_sbgp   - 华东-上海二：5_bgp、5_sbgp   - 华北-北京一：5_bgp、5_sbgp   - 中国-香港：5_bgp、5_bgp-premium   - 亚太-曼谷：5_bgp   - 亚太-新加坡：5_bgp   - 非洲-约翰内斯堡：5_bgp   - 西南-贵阳一：5_sbgp   - 华北-北京四：5_bgp、5_sbgp   - 拉美-圣地亚哥：5_bgp   - 拉美-圣保罗一：5_bgp   - 拉美-墨西哥城一：5_bgp   - 拉美-布宜诺斯艾利斯一：5_bgp   - 拉美-利马一：5_bgp   - 拉美-圣地亚哥二： 5_bgp    |
| public_ipv6_address   | String                                                                                 | **参数解释：** IPv4时无此字段，IPv6时为申请到的弹性公网IP地址。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ip_version            | Integer                                                                                | **参数解释：** IP版本信息，IPv6为开启NAT64能力。 **取值范围：** - 4：IPv4。   - 6：IPv6                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| alias                 | String                                                                                 | **参数解释：** 弹性公网IP名称。 **取值范围：** 1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   
 表6ProfileResp 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                           |
|:---|:---|:---|
| order_id   | String | **参数解释：** 订单的id。 **取值范围：** 0-36个字符。   |
| product_id | String | **参数解释：** 产品的id。 **取值范围：** 0-36个字符。   |
| region_id  | String | **参数解释：** 当前局点的id。 **取值范围：** 0-36个字符。 |
| user_id    | String | **参数解释：** 用户的id。 **取值范围：** 0-36个字符。   |
   
#### 请求示例
- 绑定id为f588ccfa-8750-4d7c-bf5d-2ede24414706的实例。
  ```
  {
    "publicip" : {
      "port_id" : "f588ccfa-8750-4d7c-bf5d-2ede24414706"
    }
  }
  ```
  
- 将弹性公网IP的ip_version更新为ipv6。
  ```
  {
    "publicip" : {
      "ip_version" : 6
    }
  }
  ```
  
- 解绑弹性公网IP的ID为3d6285c6-3a05-4513-bab5-54f6607e4fec的实例。
  ```
  {
    "publicip" : {
      "port_id" : ""
    }
  }
  ```
  
 
#### 响应示例
**状态码：200**
```
{
  "publicip" : {
    "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c",
    "bandwidth_size" : 6,
    "public_ip_address" : "161.xx.xx.7",
    "private_ip_address" : "192.xx.xx.5",
    "create_time" : "2015-07-16 04:10:52",
    "bandwidth_id" : "2f44bdaa-5a7e-449d-ac67-da00bcfbd3b8",
    "bandwidth_name" : "bandwidth123",
    "bandwidth_share_type" : "PER",
    "enterprise_project_id" : "b261ac1f-2489-4bc7-b31b-c33c3346a439",
    "profile" : { },
    "ip_version" : 4,
    "port_id" : "f588ccfa-8750-4d7c-bf5d-2ede24414706",
    "id" : "f588ccfa-8750-4d7c-bf5d-2ede24414706",
    "type" : "5_bgp",
    "status" : "PENDING_UPDATE"
  }
}
```
#### SDK代码示例
SDK代码示例如下。
- [Java]
  - 绑定id为f588ccfa-8750-4d7c-bf5d-2ede24414706的实例。
    ```
    package com.huaweicloud.sdk.test;
    import com.huaweicloud.sdk.core.auth.ICredential;
    import com.huaweicloud.sdk.core.auth.BasicCredentials;
    import com.huaweicloud.sdk.core.exception.ConnectionException;
    import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
    import com.huaweicloud.sdk.core.exception.ServiceResponseException;
    import com.huaweicloud.sdk.eip.v2.region.EipRegion;
    import com.huaweicloud.sdk.eip.v2.*;
    import com.huaweicloud.sdk.eip.v2.model.*;
    public class UpdatePublicipSolution {
        public static void main(String[] args) {
            // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
            // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
            String ak = System.getenv("CLOUD_SDK_AK");
            String sk = System.getenv("CLOUD_SDK_SK");
            String projectId = "{project_id}";
            ICredential auth = new BasicCredentials()
                    .withProjectId(projectId)
                    .withAk(ak)
                    .withSk(sk);
            EipClient client = EipClient.newBuilder()
                    .withCredential(auth)
                    .withRegion(EipRegion.valueOf("<YOUR REGION>"))
                    .build();
            UpdatePublicipRequest request = new UpdatePublicipRequest();
            request.withPublicipId("{publicip_id}");
            UpdatePublicipsRequestBody body = new UpdatePublicipsRequestBody();
            UpdatePublicipOption publicipbody = new UpdatePublicipOption();
            publicipbody.withPortId("f588ccfa-8750-4d7c-bf5d-2ede24414706");
            body.withPublicip(publicipbody);
            request.withBody(body);
            try {
                UpdatePublicipResponse response = client.updatePublicip(request);
                System.out.println(response.toString());
            } catch (ConnectionException e) {
                e.printStackTrace();
            } catch (RequestTimeoutException e) {
                e.printStackTrace();
            } catch (ServiceResponseException e) {
                e.printStackTrace();
                System.out.println(e.getHttpStatusCode());
                System.out.println(e.getRequestId());
                System.out.println(e.getErrorCode());
                System.out.println(e.getErrorMsg());
            }
        }
    }
    ```
    
  
  - 将弹性公网IP的ip_version更新为ipv6。
    ```
    package com.huaweicloud.sdk.test;
    import com.huaweicloud.sdk.core.auth.ICredential;
    import com.huaweicloud.sdk.core.auth.BasicCredentials;
    import com.huaweicloud.sdk.core.exception.ConnectionException;
    import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
    import com.huaweicloud.sdk.core.exception.ServiceResponseException;
    import com.huaweicloud.sdk.eip.v2.region.EipRegion;
    import com.huaweicloud.sdk.eip.v2.*;
    import com.huaweicloud.sdk.eip.v2.model.*;
    public class UpdatePublicipSolution {
        public static void main(String[] args) {
            // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
            // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
            String ak = System.getenv("CLOUD_SDK_AK");
            String sk = System.getenv("CLOUD_SDK_SK");
            String projectId = "{project_id}";
            ICredential auth = new BasicCredentials()
                    .withProjectId(projectId)
                    .withAk(ak)
                    .withSk(sk);
            EipClient client = EipClient.newBuilder()
                    .withCredential(auth)
                    .withRegion(EipRegion.valueOf("<YOUR REGION>"))
                    .build();
            UpdatePublicipRequest request = new UpdatePublicipRequest();
            request.withPublicipId("{publicip_id}");
            UpdatePublicipsRequestBody body = new UpdatePublicipsRequestBody();
            UpdatePublicipOption publicipbody = new UpdatePublicipOption();
            publicipbody.withIpVersion(UpdatePublicipOption.IpVersionEnum.NUMBER_6);
            body.withPublicip(publicipbody);
            request.withBody(body);
            try {
                UpdatePublicipResponse response = client.updatePublicip(request);
                System.out.println(response.toString());
            } catch (ConnectionException e) {
                e.printStackTrace();
            } catch (RequestTimeoutException e) {
                e.printStackTrace();
            } catch (ServiceResponseException e) {
                e.printStackTrace();
                System.out.println(e.getHttpStatusCode());
                System.out.println(e.getRequestId());
                System.out.println(e.getErrorCode());
                System.out.println(e.getErrorMsg());
            }
        }
    }
    ```
    
  
  - 解绑弹性公网IP的ID为3d6285c6-3a05-4513-bab5-54f6607e4fec的实例。
    ```
    package com.huaweicloud.sdk.test;
    import com.huaweicloud.sdk.core.auth.ICredential;
    import com.huaweicloud.sdk.core.auth.BasicCredentials;
    import com.huaweicloud.sdk.core.exception.ConnectionException;
    import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
    import com.huaweicloud.sdk.core.exception.ServiceResponseException;
    import com.huaweicloud.sdk.eip.v2.region.EipRegion;
    import com.huaweicloud.sdk.eip.v2.*;
    import com.huaweicloud.sdk.eip.v2.model.*;
    public class UpdatePublicipSolution {
        public static void main(String[] args) {
            // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
            // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
            String ak = System.getenv("CLOUD_SDK_AK");
            String sk = System.getenv("CLOUD_SDK_SK");
            String projectId = "{project_id}";
            ICredential auth = new BasicCredentials()
                    .withProjectId(projectId)
                    .withAk(ak)
                    .withSk(sk);
            EipClient client = EipClient.newBuilder()
                    .withCredential(auth)
                    .withRegion(EipRegion.valueOf("<YOUR REGION>"))
                    .build();
            UpdatePublicipRequest request = new UpdatePublicipRequest();
            request.withPublicipId("{publicip_id}");
            UpdatePublicipsRequestBody body = new UpdatePublicipsRequestBody();
            UpdatePublicipOption publicipbody = new UpdatePublicipOption();
            publicipbody.withPortId("");
            body.withPublicip(publicipbody);
            request.withBody(body);
            try {
                UpdatePublicipResponse response = client.updatePublicip(request);
                System.out.println(response.toString());
            } catch (ConnectionException e) {
                e.printStackTrace();
            } catch (RequestTimeoutException e) {
                e.printStackTrace();
            } catch (ServiceResponseException e) {
                e.printStackTrace();
                System.out.println(e.getHttpStatusCode());
                System.out.println(e.getRequestId());
                System.out.println(e.getErrorCode());
                System.out.println(e.getErrorMsg());
            }
        }
    }
    ```
    
   
- [Python]
  - 绑定id为f588ccfa-8750-4d7c-bf5d-2ede24414706的实例。
    ```
    # coding: utf-8
    import os
    from huaweicloudsdkcore.auth.credentials import BasicCredentials
    from huaweicloudsdkeip.v2.region.eip_region import EipRegion
    from huaweicloudsdkcore.exceptions import exceptions
    from huaweicloudsdkeip.v2 import *
    if __name__ == "__main__":
        # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak = os.environ["CLOUD_SDK_AK"]
        sk = os.environ["CLOUD_SDK_SK"]
        projectId = "{project_id}"
        credentials = BasicCredentials(ak, sk, projectId)
        client = EipClient.new_builder() \
            .with_credentials(credentials) \
            .with_region(EipRegion.value_of("<YOUR REGION>")) \
            .build()
        try:
            request = UpdatePublicipRequest()
            request.publicip_id = "{publicip_id}"
            publicipbody = UpdatePublicipOption(
                port_id="f588ccfa-8750-4d7c-bf5d-2ede24414706"
            )
            request.body = UpdatePublicipsRequestBody(
                publicip=publicipbody
            )
            response = client.update_publicip(request)
            print(response)
        except exceptions.ClientRequestException as e:
            print(e.status_code)
            print(e.request_id)
            print(e.error_code)
            print(e.error_msg)
    ```
    
  
  - 将弹性公网IP的ip_version更新为ipv6。
    ```
    # coding: utf-8
    import os
    from huaweicloudsdkcore.auth.credentials import BasicCredentials
    from huaweicloudsdkeip.v2.region.eip_region import EipRegion
    from huaweicloudsdkcore.exceptions import exceptions
    from huaweicloudsdkeip.v2 import *
    if __name__ == "__main__":
        # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak = os.environ["CLOUD_SDK_AK"]
        sk = os.environ["CLOUD_SDK_SK"]
        projectId = "{project_id}"
        credentials = BasicCredentials(ak, sk, projectId)
        client = EipClient.new_builder() \
            .with_credentials(credentials) \
            .with_region(EipRegion.value_of("<YOUR REGION>")) \
            .build()
        try:
            request = UpdatePublicipRequest()
            request.publicip_id = "{publicip_id}"
            publicipbody = UpdatePublicipOption(
                ip_version=6
            )
            request.body = UpdatePublicipsRequestBody(
                publicip=publicipbody
            )
            response = client.update_publicip(request)
            print(response)
        except exceptions.ClientRequestException as e:
            print(e.status_code)
            print(e.request_id)
            print(e.error_code)
            print(e.error_msg)
    ```
    
  
  - 解绑弹性公网IP的ID为3d6285c6-3a05-4513-bab5-54f6607e4fec的实例。
    ```
    # coding: utf-8
    import os
    from huaweicloudsdkcore.auth.credentials import BasicCredentials
    from huaweicloudsdkeip.v2.region.eip_region import EipRegion
    from huaweicloudsdkcore.exceptions import exceptions
    from huaweicloudsdkeip.v2 import *
    if __name__ == "__main__":
        # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak = os.environ["CLOUD_SDK_AK"]
        sk = os.environ["CLOUD_SDK_SK"]
        projectId = "{project_id}"
        credentials = BasicCredentials(ak, sk, projectId)
        client = EipClient.new_builder() \
            .with_credentials(credentials) \
            .with_region(EipRegion.value_of("<YOUR REGION>")) \
            .build()
        try:
            request = UpdatePublicipRequest()
            request.publicip_id = "{publicip_id}"
            publicipbody = UpdatePublicipOption(
                port_id=""
            )
            request.body = UpdatePublicipsRequestBody(
                publicip=publicipbody
            )
            response = client.update_publicip(request)
            print(response)
        except exceptions.ClientRequestException as e:
            print(e.status_code)
            print(e.request_id)
            print(e.error_code)
            print(e.error_msg)
    ```
    
   
- [Go]
  - 绑定id为f588ccfa-8750-4d7c-bf5d-2ede24414706的实例。
    ```
    package main
    import (
    "fmt"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
        eip "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2/model"
        region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2/region"
    )
    func main() {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak := os.Getenv("CLOUD_SDK_AK")
        sk := os.Getenv("CLOUD_SDK_SK")
        projectId := "{project_id}"
        auth, err := basic.NewCredentialsBuilder().
            WithAk(ak).
            WithSk(sk).
            WithProjectId(projectId).
            SafeBuild()
        if err != nil {
            fmt.Println(err)
            return
        }
        hcClient, err := eip.EipClientBuilder().
             WithRegion(region.ValueOf("<YOUR REGION>")).
             WithCredential(auth).
             SafeBuild()
        if err != nil {
            fmt.Println(err)
            return
        }
        client := eip.NewEipClient(hcClient)
        request := &model.UpdatePublicipRequest{}
    request.PublicipId = "{publicip_id}"
    portIdPublicip:= "f588ccfa-8750-4d7c-bf5d-2ede24414706"
    publicipbody := &model.UpdatePublicipOption{
    PortId: &portIdPublicip,
    }
    request.Body = &model.UpdatePublicipsRequestBody{
    Publicip: publicipbody,
    }
    response, err := client.UpdatePublicip(request)
    if err == nil {
            fmt.Printf("%+v\n", response)
        } else {
            fmt.Println(err)
        }
    }
    ```
    
  
  - 将弹性公网IP的ip_version更新为ipv6。
    ```
    package main
    import (
    "fmt"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
        eip "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2/model"
        region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2/region"
    )
    func main() {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak := os.Getenv("CLOUD_SDK_AK")
        sk := os.Getenv("CLOUD_SDK_SK")
        projectId := "{project_id}"
        auth, err := basic.NewCredentialsBuilder().
            WithAk(ak).
            WithSk(sk).
            WithProjectId(projectId).
            SafeBuild()
        if err != nil {
            fmt.Println(err)
            return
        }
        hcClient, err := eip.EipClientBuilder().
             WithRegion(region.ValueOf("<YOUR REGION>")).
             WithCredential(auth).
             SafeBuild()
        if err != nil {
            fmt.Println(err)
            return
        }
        client := eip.NewEipClient(hcClient)
        request := &model.UpdatePublicipRequest{}
    request.PublicipId = "{publicip_id}"
    ipVersionPublicip:= model.GetUpdatePublicipOptionIpVersionEnum().E_6
    publicipbody := &model.UpdatePublicipOption{
    IpVersion: &ipVersionPublicip,
    }
    request.Body = &model.UpdatePublicipsRequestBody{
    Publicip: publicipbody,
    }
    response, err := client.UpdatePublicip(request)
    if err == nil {
            fmt.Printf("%+v\n", response)
        } else {
            fmt.Println(err)
        }
    }
    ```
    
  
  - 解绑弹性公网IP的ID为3d6285c6-3a05-4513-bab5-54f6607e4fec的实例。
    ```
    package main
    import (
    "fmt"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
        eip "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2/model"
        region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v2/region"
    )
    func main() {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak := os.Getenv("CLOUD_SDK_AK")
        sk := os.Getenv("CLOUD_SDK_SK")
        projectId := "{project_id}"
        auth, err := basic.NewCredentialsBuilder().
            WithAk(ak).
            WithSk(sk).
            WithProjectId(projectId).
            SafeBuild()
        if err != nil {
            fmt.Println(err)
            return
        }
        hcClient, err := eip.EipClientBuilder().
             WithRegion(region.ValueOf("<YOUR REGION>")).
             WithCredential(auth).
             SafeBuild()
        if err != nil {
            fmt.Println(err)
            return
        }
        client := eip.NewEipClient(hcClient)
        request := &model.UpdatePublicipRequest{}
    request.PublicipId = "{publicip_id}"
    portIdPublicip:= ""
    publicipbody := &model.UpdatePublicipOption{
    PortId: &portIdPublicip,
    }
    request.Body = &model.UpdatePublicipsRequestBody{
    Publicip: publicipbody,
    }
    response, err := client.UpdatePublicip(request)
    if err == nil {
            fmt.Printf("%+v\n", response)
        } else {
            fmt.Println(err)
        }
    }
    ```
    
   
- [更多]
  更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/EIP/sdk?api=UpdatePublicip&version=v2)的代码示例页签，可生成自动对应的SDK代码示例。
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | GET和PUT操作正常返回 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-eip/ErrorCode.html)。
