EIP实例

更新时间：2025-08-21

创建EIP

申请一个EIP，可用于绑定到任意BCC、BLB等实例

创建EIP需要实名认证，若未通过实名认证可以前往百度开放云官网控制台中的安全认证下的实名认证中进行认证。

函数声明

                Python
                
                def create_eip(self, bandwidth_in_mbps, name=None, billing=None,
               client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Wjwvz30fv

返回值

操作成功：

                JSON
                
                {
    "eip":"180.181.3.133"
}

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_create_eip.py

EIP带宽扩缩容

用于指定EIP的带宽扩缩容

通过查询EIP列表查看EIP扩缩容状态是否完成

函数声明

                Python
                
                def resize_eip(self, eip, new_bandwidth_in_mbps, client_token=None,
                   config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Hjwvz325u

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_resize_eip.py

绑定EIP

绑定EIP到某个实例,如BCC、BLB、BBC等

只有available状态的EIP支持绑定操作

被绑定的实例不能存在任何已有EIP绑定关系

被绑定的实例不能处于欠费状态

函数声明

                Python
                
                def bind_eip(self, eip, instance_type, instance_id, client_token=None,
                 config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/9jwvz31gn

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_bind_eip.py

解绑EIP

解除指定EIP的绑定关系

被解绑的EIP必须已经绑定到任意实例

函数声明

                Python
                
                def unbind_eip(self, eip, client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Djwvz314s

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_unbind_eip.py

释放EIP

释放指定EIP，被释放的EIP无法找回

如果EIP被绑定到任意实例，需要先解绑才能释放

函数声明

                Python
                
                def release_eip(self, eip, client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Rjwvz32ig

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_release_eip.py

查询EIP列表

可根据多重条件查询EIP列表。

如只需查询单个EIP的详情，只需提供eip参数即可。

如只需查询绑定到指定类型实例上的EIP，提供instanceType参数即可。

如只需查询指定实例上绑定的EIP的详情，提供instanceType及instanceId参数即可。

若不提供查询条件，则默认查询覆盖所有EIP。

返回结果为多重条件交集的查询结果，即提供多重条件的情况下，返回同时满足所有条件的EIP。

以上查询结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定。

函数声明

                Python
                
                def list_eips(self, eip=None, instance_type=None, instance_id=None, status=None, 
              marker=None,  max_keys=1000, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Pjwvz30qy

返回值

操作成功：

                JSON
                
            

                {
    "eipList": [
        {
            "name":"eip-xxxxxxx-1",
            "eip": "x.x.x.x",
            "status":"binded",
            "instanceType": "BCC",
            "instanceId": "i-xxxxxxx",
            "bandwidthInMbps": 5,
            "paymentTiming":"Prepaid",
            "billingMethod":"ByBandwidth",
            "createTime":"2023-10-08T08:13:09Z",
            "expireTime":"2023-12-08T08:13:09Z"
        },
        {
            "name":"eip-xxxxxxx-1",
            "eip": "x.x.x.x",
            "status":"binded",
            "instanceType": "BCC",
            "instanceId": "i-xxxxxxx",
            "bandwidthInMbps": 1,
            "paymentTiming":"Postpaid",
            "billingMethod":"ByTraffic",
            "createTime":"2023-09-08T08:13:09Z",
            "expireTime":null
        },
    ],
    "marker":"eip-xxxxxxx-1",
    "isTruncated": true,
    "nextMarker": "eip-DCB50387",
    "maxKeys": 2
}
            

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_list_eips.py

EIP续费

针对指定EIP的续费操作，延长过期时长

EIP扩缩容期间不能进行续费操作。

函数声明

                Python
                
                def purchase_reserved_eip(self, eip, billing=None, client_token=None,
                              config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Yjwvz31ty

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_purchase_reserved_eip.py

EIP开启自动续费

EIP 计费方式为预付费类型

EIP 无计费变更任务

EIP 未开通自动续费

函数声明

                Python
                
                def start_auto_renew_eip(self, eip, auto_renew_time_unit=None, auto_renew_time=None, 
                             client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Sk9gykbek

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_start_auto_renew.py

EIP关闭自动续费

需要EIP已经开通自动续费

函数声明

                Python
                
                def stop_auto_renew_eip(self, eip, client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Sk9gykbek

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_stop_auto_renew.py

开启EIP直通

EIP必须绑定到某个BCC、DCC、ENI、BLB等实例

                Python
                
                def direct_eip(self, eip, client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/aknohnbq1

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_direct_eip.py

关闭EIP直通

EIP必须已经开启直通功能

                Python
                
                def undirect_eip(self, eip, client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Pknohwcdb

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_undirect_eip.py

查询回收站内EIP列表

查询用户账号下回收站内EIP信息。

支持按EIP的eip、name进行查询，eip、name 均支持模糊搜索。

若不提供查询条件，则默认查询覆盖所有EIP。

返回结果是多重条件交集的查询结果，即提供多重条件的情况下，返回同时满足所有条件的EIP。

结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定。

函数声明

                Python
                
                def list_eip_recycle(self, eip=None, name=None, marker=None, max_keys=1000, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/dl0anm1j8

返回值

操作成功：

                JSON
                
            

                {
    "eipList": [
        {
            "name":"eip-xxxxxxx-1",
            "eip": "x.x.x.x",
            "eip_id":"ip-xxxxxxxx",
            "status": "paused",
            "route_type": "BGP",
            "bandwidth_in_mbps": 5,
            "payment_timing":"Prepaid",
            "billing_method":"ByBandwidth",
            "recycle_time":"2023-07-08T08:13:09Z",
            "scheduled_delete_time":"2023-08-08T08:13:09Z"
        },
        {
            "name":"eip-xxxxxxx-2",
            "eip": "x.x.x.x",
            "eip_id":"ip-xxxxxxxx",
            "status": "paused",
            "route_type": "BGP",
            "bandwidth_in_mbps": 10,
            "payment_timing":"Postpaid",
            "billing_method":"ByBandwidth",
            "recycle_time":"2023-06-08T08:13:09Z",
            "scheduled_delete_time":"2023-07-08T08:13:09Z"
        },
    ],
    "marker":"ip-xxxxxxxx",
    "is_truncated": true,
    "max_keys": 1000
}
            

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_list_recycle_eip.py

选择性释放EIP

选择将指定EIP直接释放或放入回收站内，默认直接释放。

预付费已到期、后付费-按流量、后付费-按带宽状态的 EIP 实例可以选择放入回收站或直接释放。

释放指定EIP，被释放的EIP无法找回。

回收站内EIP实例保留7天，超过7天则自动释放不可恢复；7天内可以手动选择恢复或删除指定EIP。

EIP实例如果被绑定到任意实例，需要先解绑才能直接释放。

EIP实例进入回收站后，强制解除绑定关系，恢复实例后需重新配置。

在回收站的EIP有配额限制，默认在每个地域回收站保留10个EIP，按时间倒序。当回收站内EIP数额达到10个时，新进入的EIP会挤走之前的EIP。

若EIP实例为后付费已欠费，无论何种选择系统都将直接释放EIP实例。

函数声明

                Python
                
                def optional_delete_eip(self, eip, release_to_recycle=False, client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/zl0anqxgo

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_optional_delete_eip.py

释放回收站内EIP

释放回收站内指定EIP

函数声明

                Python
                
                def delete_recycle_eip(self, eip, client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/sl0anla1w

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_delete_recycle_eip.py

恢复回收站内EIP

恢复回收站内指定EIP计费

若EIP付款方式为预付费，则通过续费操作恢复计费，续费时长为1个月

若EIP付款方式为后付费，则恢复原有计费方式

函数声明

                Python
                
                def restore_recycle_eip(self, eip, client_token=None, config=None):

参数含义

请参考OpenAPI文档：https://cloud.baidu.com/doc/EIP/s/Gl0anfp4g

返回值

操作成功：

无特殊返回参数

操作失败：

抛出异常，异常列表参考：https://cloud.baidu.com/doc/EIP/s/Fk09snej9

代码示例

具体代码示例参考：example_restore_recycle_eip.py

EipTp实例

版本说明

弹性公网IP EIP

弹性公网IP EIP

EIP实例

创建EIP

EIP带宽扩缩容

绑定EIP

解绑EIP

释放EIP

查询EIP列表

EIP续费

EIP开启自动续费

EIP关闭自动续费

开启EIP直通

关闭EIP直通

查询回收站内EIP列表

选择性释放EIP

释放回收站内EIP

恢复回收站内EIP