跨区带宽使用场景（GEIP） 本示例中，以GEIP绑定至E CS 为例： GEIP绑定的ECS所在区域为中国-香港，GEIP接入点为华东-杭州，中国-香港属于亚太大区，华东-杭州属于中国大陆大区 ，因此全域互联带宽应该选择跨区带宽。 本端大区：选择ECS所在大区，此处为亚太。 对端大区：选择GEIP接入点所在大区，此处为中国大陆。 本端必须选择GEIP绑定资源所在的大区，对端选择GEIP接入点所在的大区，请务必确保本端和对端大区选择正确。 图3 跨区带宽使用场景（GEIP）

大区/跨区带宽使用场景（中心网络） 本示例中，以云连接中接入ER为例： 连接ER1和ER2：ER1位所在区域为华东-上海一，ER2所在区域为华南-广州，华东-上海一和华南-广州都属于中国大陆大区，因此连接ER1和ER2的全域互联带宽应该选择大区带宽。 连接ER1和ER3：ER1位所在区域为华东-上海一，ER3所在区域为中国-香港，华东-上海一属于中国大陆大区，中国-香港属于亚太大区，因此连接ER1和ER3的全域互联带宽应该选择跨区带宽。 本端大区：选择ER1所在大区，此处为中国大陆。 对端大区：选择ER3所在大区，此处为亚太。 本端也可以选择ER3所在大区，对端选择ER1所在大区，本端和对端不做严格区分，只要确保两端的ER均已接入带宽中即可。 连接ER2和ER3：ER2位所在区域为华南-广州，ER3所在区域为中国-香港，华南-广州属于中国大陆大区，中国-香港属于亚太大区，因此连接ER2和ER3的全域互联带宽应该选择跨区带宽。 本端大区：选择ER2所在大区，此处为中国大陆。 对端大区：选择ER3所在大区，此处为亚太。

约束与限制 目前仅支持添加同一带宽区域类型下的实例。 一个全域互联带宽仅能添加一种实例类型，首次添加了实例类型后仅可添加该类型下的子实例，如需添加其他实例类型，请进行移出后重新添加。 全域弹性公网IP实例：支持批量添加和移出实例。 云连接实例：仅支持添加和移出一个实例。 不同带宽类型的全域互联带宽可配合不同的实例使用，详情见表1。 表1 全域互联带宽添加实例说明 带宽类型 全域弹性公网IP 中心网络 城域带宽 √ × 跨区带宽 √ √ 大区带宽 √ √

全域弹性公网IP概述 全域弹性公网IP（Global Elastic IP, GEIP）提供全球公网接入能力，支持用户指定全局区域及地址池创建公网IP地址，可跨区域绑定云上任意区域的实例（如ECS、ELB等），实现云上资源和公网通信。全域弹性公网IP需要绑定全域互联带宽和全域公网带宽实现云内骨干网络通信和公网通信。如果实例为ECS时，还需要将互联网网关绑定至全域弹性公网IP。全域公网带宽架构如图1所示。 图1 全域弹性公网IP架构 表1 全域弹性公网IP操作说明 通信场景 所需资源 场景说明 举例说明 操作指导 云内通信 全域弹性公网IP 全域互联带宽 和全域弹性公网IP绑定的实例，比如ECS、ELB 连通GEIP和实例之间的云内网络，必须为GEIP绑定全域互联带宽，根据GEIP接入点和实例所在区域，选择不同类型的全域互联带宽，全域互联带宽同时只能绑定一个GEIP。 关于全域互联带宽的详细信息，请参见全域互联带宽概述。 GEIP-A的接入点为华东-杭州，GEIP-A绑定的ELB-A所在区域为华东-上海一，华东-杭州和华东-上海一均属于华东城域，因此全域互联带宽-A选择城域带宽。 GEIP-B的接入点为华东-杭州，GEIP-B绑定的ECS-B所在区域为华南-广州，华东-杭州和华南-广州属于不同城域，但是属于同一个大区，因此全域互联带宽-B选择大区带宽。 GEIP-C的接入点为华东-杭州，GEIP-C绑定的ECS-C所在区域为中国-香港，华东-杭州和中国-香港属于不同的大区，因此全域互联带宽-C选择跨区带宽。 创建全域弹性公网IP：创建一个或者多个GEIP。 将全域弹性公网IP绑定至实例：将GEIP绑定至ECS或者ELB实例，一个GEIP同时只能绑定一个实例。 将实例添加至全域互联带宽： 为GEIP绑定全域互联带宽，全域互联带宽同时只能绑定一个GEIP。 公网通信 全域弹性公网IP 全域公网带宽 和全域弹性公网IP绑定的实例，比如ECS、ELB 连通GEIP和公网之间的网络，必须将GEIP加入全域公网带宽中，GEIP接入点和全域公网带宽保持一致，一个全域公网带宽中可同时加入多个GEIP。 关于全域公网带宽的详细信息，请参见全域公网带宽概述。 将GEIP-A、GEIP-B、GEIP-C添加到全域公网带宽-A中，GEIP和全域公网带宽的接入点必须保持一致，此处均为华东-杭州，带宽的复用为您节约网络成本。 购买全域公网带宽：购买全域公网带宽，全域公网带宽中的接入点必须和GEIP的接入点保持一致。 迁入全域弹性公网IP：将GEIP添加到全域公网带宽中，一个全域公网带宽中可同时加入多个GEIP。 父主题： 全域弹性公网IP

EIP资源在什么情况下会被冻结，如何解除被冻结的EIP资源？ 欠费被冻结 包年包月EIP资源 保留期，指宽限期到期后客户的包年/包月资源仍未续订，将进入保留期。保留期即被冻结状态。被冻结的资源不可用，也不能修改、删除。超过保留期仍未续费，冻结资源将被释放，被释放资源不可恢复。为确保资源持续可用，请在资源到期前及时续费。 宽限期和保留期时长因客户等级不同而不同，详细请参考宽限期和保留期时长限制。 按需EIP资源 指宽限期到期后客户的按需资源仍在欠费，将资源置于欠费状态并进入保留期，即被冻结状态。被冻结的资源不可用，也不能修改、删除。超过保留期仍未充值缴清欠费金额，冻结资源将被释放，被释放资源不可恢复。为确保资源持续可用，请在资源到期前完成充值，并确保所欠金额已结清。 冻结的EIP资源在续费或充值后会变为可用状态。如需续费，请在管理控制台续费管理页面进行续费操作。详细操作请参考续费管理。 EIP绑定的实例对外有攻击被冻结 EIP资源绑定的服务器如果对外有攻击等安全违规行为，即被冻结状态，在控制台上显示为冻结（违规冻结）。被冻结的资源不可用，也不能修改、删除。若要解除冻结状态，请提交工单。您还可以参考如何为实例解绑已有弹性公网IP，绑定新的弹性公网IP？为实例更换EIP。 EIP绑定的实例涉嫌违规被冻结 EIP资源绑定的服务器涉嫌违规行为，被国家监管部门冻结。如您通过自检确认未曾涉嫌违规操作，请联系国家监管部门进行申诉，如申诉成功，华为云将获得解封指令解冻您的资源。您还可以参考如何为实例解绑已有弹性公网IP，绑定新的弹性公网IP？为实例更换EIP。 父主题： 产品咨询类

约束与限制 未绑定至实例的弹性公网IP地址才可以释放，已绑定实例的弹性公网IP需要先解绑，具体请参见将弹性公网IP和实例解绑。 弹性公网IP释放后，如果被其他用户使用，则无法找回，请您谨慎操作。 如果您要找回指定弹性公网IP，具体请参见如何创建或找回指定的弹性公网IP？。 对于包年/包月计费模式的EIP不支持释放，如您不再使用，可以退订EIP。 EIP资源绑定的服务器涉嫌违规行为，被国家监管部门冻结时，无法进行释放操作。

修订记录 发布日期 修改说明 2023-10-18 第三十七次正式发布。 更新： 创建全域弹性公网IP，增加公网IP段内容。 2023-08-02 第三十六次正式发布。 更新： 变更弹性公网IP计费方式，增加包年/包月即时转按需计费（按带宽计费）的操作步骤。 2023-07-28 第三十五次正式发布。 文档更新如下： 带宽加油包简介章节，增加带宽加油包可以立即生效，并且在同时段内可以叠加使用功能。 2023-06-28 第三十四次正式发布。 更新： 全域公网带宽，全域公网带宽结束公测，转商用。 全域弹性公网IP，增加云连接路径。 2023-06-16 第三十三次正式发布。文档内容更新为： 在添加弹性公网IP到共享带宽章节，增加EIP跨带宽迁移能力的说明。 2023-06-09 第三十二次正式发布。 文档更新如下： 共享带宽简介，增加按需计费的共享带宽升配的约束限制。 2023-05-18 第三十一次正式发布。 文档更新如下： 支持的监控指标，增加入网带宽使用率说明和带宽变更延迟说明相关内容。 2023-05-04 第三十次正式发布。 文档更新如下： 申请弹性公网IP，增加DDos防护相关内容。 2023-04-25 第二十九次正式发布。 文档更新如下： 将全域弹性公网IP绑定至实例，增加GEIP绑定的实例类型NAT。 2023-03-27 第二十八次正式发布。 文档新增章节为： 查看弹性公网IP计费情况。 2023-03-02 第二十八次正式发布。 更新： 全域弹性公网IP，全域弹性公网IP结束公测，转商用。 2023-02-09 第二十七次正式发布。 全域弹性公网IP开启公测，文档新增内容为： 全域公网带宽。 全域弹性公网IP。 2023-01-05 第二十六次正式发布。 更新： 公网IP池，公网IP池结束公测，转商用。 2022-11-10 第二十五次正式发布。 新增：全域互联带宽。 更新： 共享流量包简介，添加到价格计算器详情页的链接作为价格参考。 2022-10-31 第二十四次正式发布。 新增： 企业级QoS功能。 2022-08-12 第二十三次正式发布。 优化IPv6章节： IPv6弹性公网IP。 2022-07-26 第二十二次正式发布。 新增EIP不支持跨区域使用限制、带宽加油包支持的区域、普通可用区和边缘可用区的EIP资源使用限制，更新章节： 什么是弹性公网IP？。 约束与限制。 为弹性云服务器申请和绑定弹性公网IP。 弹性公网IP简介。 申请弹性公网IP。 将弹性公网IP绑定至实例。 共享带宽简介。 添加弹性公网IP到共享带宽。 带宽加油包简介。 新增章节：导出监控数据。 2022-07-14 第二十一次正式发布。 优选BGP相关描述优化更新： 更新章节： 什么是弹性公网IP？。 申请弹性公网IP。 静态BGP、全动态BGP、优选BGP之间有何区别？。 优选BGP线路在什么场景下使用，以及有什么使用约束？。 新增章节：跨境访问出现短时间时延抖动或丢包，如何解决？。 2022-05-16 第二十次正式发布。文档内容更新为： 修改弹性公网IP费用内容：变更弹性公网IP计费方式、为包年/包月弹性公网IP续费。 2021-12-28 第十九次正式发布。文档内容更新为： 在IPv6弹性公网IP中，增加IPv6网络的应用场景。 2021-11-01 第十八次正式发布。文档内容更新为： 新增“优选BGP线路”， 在申请弹性公网IP中，修改参数“线路”的描述。 在申请共享带宽、添加弹性公网IP到共享带宽中，增加参数“线路”以及相关约束与限制说明。 在共享流量包简介、带宽加油包简介中，增加约束与限制说明。 2021-05-12 第十七次正式发布。文档内容更新为： 新增“公网IP池”章节。 2021-02-20 第十六次正式发布。文档内容更新为： 常见问题新增：EIP资源在什么情况下会被冻结，如何解除被冻结的EIP资源？ 常见问题新增：如何查询EIP使用量？ 2021-01-08 第十五次正式发布。文档内容更新为： 从共享带宽移出EIP时，支持设置EIP移出后规格，包括计费模式和带宽大小。 2020-12-01 第十四次正式发布。文档内容更新为： 常见问题删除“什么是弹性公网IP？”。 常见问题“静态BGP与全动态BGP有何区别？”补充计费信息。 2020-11-03 第十三次正式发布。文档内容更新为： 新增常见问题：在管理控制台找不到已购EIP怎么办？ 删除常见问题：弹性云服务器关机再开机后，其绑定的弹性公网IP是否会改变？ 2020-09-07 第十二次正式发布。文档内容更新为： 在“什么是弹性公网IP”章节，补充线路类型信息。 修改常见问题：EIP连接出现问题时，如何排查？ 2020-07-28 第十一次正式发布。文档内容更新为： 新增“配置剩余使用量预警”章节。 常见问题新增：共享流量包与共享带宽有什么区别？ 常见问题新增：共享流量包购买后需要设置吗？ 修改常见问题：如何查询弹性公网IP归属地？ 在“使用限制”章节，新增入云限速规则调整说明。 2020-06-18 第十次正式发布。文档内容更新为： 常见问题新增“弹性公网IP Ping不通？”。 常见问题新增“EIP出现封堵后，如何解封？”。 2020-05-26 第九次正式发布。文档内容更新为： 常见问题结构调整。 常见问题新增“一台弹性云服务器云主机是否可以绑定多个弹性公网IP？”。 2020-04-15 第八次正式发布。文档内容更新为： 常见问题新增“弹性公网IP是否支持跨区域绑定?”。 2020-03-30 第七次正式发布。文档内容更新为： 产品介绍新增“计费说明”章节。 常见问题新增“计费类”。 2020-03-26 第六次正式发布。文档内容更新为： 新增“导出弹性IP弹性公网IP列表”章节。 常见问题新增“如何查询弹性公网IP归属地？”。 常见问题新增“弹性公网IP是否支持转移给其他帐号？”。 2020-02-18 第五次正式发布。文档内容更新为： 常见问题新增“弹性公网IP如何计费？”。 优化常见问题“一个弹性公网IP可以给几个弹性云服务器使用？”。 2020-02-10 第四次正式发布。文档内容更新为： 修改“权限管理”章节，VPC系统权限名称变更。 2020-01-20 第三次正式发布。文档内容更新为： 修改“权限管理”章节内容。 2020-01-14 第二次正式发布。 优化“产品介绍”。 新增弹性公网IP费用章节。 2019-12-10 第一次正式发布。

带宽 共享带宽只能加入按需计费的EIP。 共享带宽支持按带宽计费、增强型95计费。按带宽计费5Mbit/s起售，增强型95计费300Mbit/s起售。 共享带宽可支持加入20个EIP，如果您需要加入更多EIP，请提交工单申请。 通用可用区的共享带宽不支持添加边缘可用区的EIP，边缘可用区的共享带宽也不支持添加通用可用区的EIP。 关于边缘可用区和普通可用区的区别请参考《智能边缘小站用户指南》。 每个用户最多申请5个共享带宽，如果您需要更多共享带宽，请提交工单申请。 对包年包月EIP使用的独享带宽，在当前带宽周期内只能提升带宽上限不能降低带宽上限，如果需要降低带宽规格，请在当前带宽周期到期后，重新续费时降低带宽规格。 共享带宽和独享带宽均不支持跨帐号使用。 为了保证云上资源管控通道的稳定，弹性公网IP对22、500、3389、4500等端口设定了特殊的限速保护规则。 入云方向是指Internet流入华为云内方向，出云方向是指华为云内流出到Internet方向。 2020年7月31日 00:00（北京时间）之后，华北-北京四、华东-上海一、华南-广州、西南-贵阳一、华北-乌兰察布一等所有中国大陆区域针对公网带宽进行限速规则调整。 2021年12月10日 00:00（北京时间）之后，中国-香港、亚太-曼谷、亚太-新加坡、非洲-约翰内斯堡、拉美-墨西哥城二、拉美-圣保罗一、拉美-圣地亚哥等区域针对公网带宽进行限速规则调整。 调整后的规则如下： 若您购买/修改后的带宽大小小于或等于10Mbit/s，则入云方向带宽为10Mbit/s，出云方向带宽大小为购买/修改后的带宽大小。 若您购买/修改后的带宽大小大于10Mbit/s，则出云方向和入云方向带宽相同，都等于购买/修改后的带宽大小。 增强型95计费取入云方向和出云方向中较大的带宽平均值作为采样点的带宽值进行收费。

共享流量包 共享流量包费用为一次性支付，即刻生效，不支持指定生效日期。 共享流量包一旦购买不支持退订，到期后也不支持续订。 共享流量包支持包月和包年，到期后剩余的流量将无法再使用。 共享流量包只能针对按需计费（按流量计费）的带宽生效，且需要区分动态BGP和静态BGP类型。动态BGP共享流量包适用于动态BGP按需计费（按流量计费）的独享带宽，静态BGP共享流量包适用于静态BGP按需计费（按流量计费）的独享带宽。 共享流量包不支持对指定的某一个EIP带宽生效。 共享流量包不支持对共享带宽生效。 共享流量包不支持用于优选BGP类型的EIP。

弹性公网IP 关于弹性公网IP的使用，您需要注意以下几点： 一个弹性公网IP只能绑定一个云资源使用，且弹性公网IP和云资源必须在同一个区域，不支持跨区域使用弹性公网IP。 不同区域用户，可申请的EIP配额不同，可参考怎样查看和申请扩大我的配额？来查看您的EIP配额以及申请扩大您的EIP配额。 申请提升配额，要求该帐户下存在有效订单和持续使用的云服务资源，如您的帐户之前存在多次订购资源后即时释放的情况，不能提升配额。 对于长期闲置的EIP资源配额，华为云将降低配额至默认值，如需提升配额，您可通过提交工单申请。 如您违反适用法律法规的要求使用华为云EIP资源，华为云有权收回EIP资源，并暂停向您提供服务。 只有未绑定状态的EIP才能进行绑定操作。 通用可用区的EIP不支持绑定至边缘可用区的实例，边缘可用区的EIP也不支持绑定至通用可用区的实例。 关于边缘可用区和普通可用区的区别请参考《智能边缘小站用户指南》。 按需计费的带宽上限以页面显示为准，如果您需要更大的带宽，请提交工单申请或联系您的客户经理。 当带宽严重超限或受到攻击时（一般是受到了DDoS攻击），EIP会被封堵，但不影响对EIP资源的绑定、解绑等操作。 未绑定的弹性公网IP地址才可释放，已绑定的弹性公网IP地址需要先解绑定后才能释放。 弹性公网IP释放后，如果被其他用户使用，则无法找回。

响应示例 状态码： 200 POST操作正常返回 { "publicips" : [ { "statusCode" : 200, "publicip" : { "alias" : "test", "associate_instance_id" : null, "associate_instance_type" : null, "bandwidth" : { "id" : "e6af636c-ea79-4c20-ba2f-402057ba7886", "size" : 5, "share_type" : "WHOLE", "charge_mode" : "traffic", "name" : "bandwidth-b8ff", "billing_info" : "" }, "billing_info" : null, "created_at" : "2020-07-10T10:10:18Z", "description" : "", "enterprise_project_id" : "0", "id" : "99c8a2df-9e90-48df-9132-e2216e659459", "ip_version" : 4, "lock_status" : null, "project_id" : "8d53f081ea24444aa95e2bfa942ef6ee", "public_border_group" : "center", "public_ip_address" : "10.246.165.44", "public_ipv6_address" : null, "publicip_pool_id" : "ece62314-858c-4793-a768-346efca42131", "publicip_pool_name" : "5_bgp", "status" : "ACTIVE", "type" : "EIP", "updated_at" : "2020-07-11T05:03:25Z", "vnic" : { "device_id" : "cc03e7f7-b820-4a2e-b243-8022daabf0cf", "device_owner" : "compute:br-iaas-odin1a", "instance_id" : "", "instance_type" : "", "mac" : "fa:16:3e:7a:5f:db", "port_id" : "fb68a8e1-b93e-4100-8735-6d6b0a6a0eb5", "port_profile" : "", "private_ip_address" : "192.168.3.222", "vni" : "435405", "vpc_id" : "ac17491b-0769-4d96-b883-6d6295f6afad", "vtep" : "18.8.152.158" } } }, { "statusCode" : 200, "publicip" : { "alias" : "test", "associate_instance_id" : null, "associate_instance_type" : null, "bandwidth" : { "id" : "e6af636c-ea79-4c20-ba2f-402057ba7886", "size" : 5, "share_type" : "WHOLE", "charge_mode" : "traffic", "name" : "bandwidth-b8ff", "billing_info" : "" }, "billing_info" : null, "created_at" : "2020-07-10T10:10:18Z", "description" : "", "enterprise_project_id" : "0", "id" : "7b484d78-550a-4e92-8363-a34b5194ddcb", "ip_version" : 4, "lock_status" : null, "project_id" : "8d53f081ea24444aa95e2bfa942ef6ee", "public_border_group" : "center", "public_ip_address" : "10.246.165.45", "public_ipv6_address" : null, "publicip_pool_id" : "ece62314-858c-4793-a768-346efca42131", "publicip_pool_name" : "5_bgp", "status" : "ACTIVE", "type" : "EIP", "updated_at" : "2020-07-11T05:03:25Z", "vnic" : { "device_id" : "cc03e7f7-b820-4a2e-b243-8022daabf0dd", "device_owner" : "compute:br-iaas-odin1a", "instance_id" : "", "instance_type" : "", "mac" : "fa:16:3e:7a:5f:cc", "port_id" : "fb68a8e1-b93e-4100-8735-6d6b0a6a0eb6", "port_profile" : "", "private_ip_address" : "192.168.3.221", "vni" : "435405", "vpc_id" : "ac17491b-0769-4d96-b883-6d6295f6afad", "vtep" : "18.8.152.158" } } } ], "request_id" : "db4b975a79d1da86dda3d02054f11e16" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 publicips Array of BatchPublicipResp objects 弹性公网IP对象 request_id String 本次请求编号 表5 BatchPublicipResp 参数 参数类型 描述 statusCode Integer 响应码 publicip PublicipResp object 弹性公网IP对象 表6 PublicipResp 参数 参数类型 描述 id String 功能说明：弹性公网IP的唯一标识 最小长度：36 最大长度：36 project_id String 功能说明：项目ID 最小长度：32 最大长度：32 ip_version Integer 功能说明: 弹性公网IP版本号 取值范围: 4、6，6为开启NAT64能力 4表示公网IP地址为public_ip_address地址 6表示公网IP地址为public_ipv6_address地址 最小值：4 最大值：6 枚举值： 4 6 public_ip_address String 功能说明: 弹性公网IPv4地址 最小长度：0 最大长度：64 public_ipv6_address String 功能说明: 弹性公网IPv6地址 最小长度：0 最大长度：64 status String 功能说明：弹性公网IP的状态 取值范围：FREEZED，DOWN，ACTIVE，ERROR。 FREEZED表示弹性公网IP处于冻结状态 DOWN表示弹性公网IP未绑定实例 ACTIVE表示弹性公网IP绑定实例，正在使用中 ERROR表示弹性公网IP状态异常 最小长度：0 最大长度：16 枚举值： FREEZED DOWN ACTIVE ERROR description String 功能说明：弹性公网IP的描述信息 约束：用户以自定义方式标识资源，系统不感知 最小长度：0 最大长度：1024 created_at String 功能说明：弹性公网IP的创建时间 约束：UTC时间格式（2018-12-25T10:07:24Z） 最小长度：0 最大长度：64 updated_at String 功能说明：弹性公网IP最近的更新时间 约束：UTC时间格式（2018-12-25T10:09:20Z） 最小长度：0 最大长度：64 type String 功能说明：弹性公网IP的类型 取值范围：EIP，DUALSTACK 最小长度：0 最大长度：36 枚举值： EIP DUALSTACK vnic VnicResp object 功能说明：弹性公网IP绑定实例有PORT时，PORT的相关信息 约束：若绑定的实例不依赖PORT，该对象为null bandwidth BandwidthResp object 功能说明：弹性公网IP绑定的带宽信息 enterprise_project_id String 功能说明：弹性公网IP的企业项目ID 最小长度：32 最大长度：32 billing_info String 功能说明：弹性公网IP的订单信息 约束：包周期才会有订单信息，按需资源此字段为空 最小长度：0 最大长度：1024 lock_status String 功能说明：记录弹性公网IP当前的冻结状态 约束：metadata类型，标识欠费冻结、公安冻结 最小长度：0 最大长度：36 associate_instance_type String 功能说明：弹性公网IP绑定的实例类型 取值范围：PORT、NATGW、ELB、ELBV1、VPN 最小长度：0 最大长度：36 枚举值： PORT NATGW ELB ELBV1 VPN associate_instance_id String 功能说明：弹性公网IP绑定的实例ID 最小长度：0 最大长度：36 publicip_pool_id String 功能说明：弹性公网IP所属网络的ID。publicip_pool_name对应的网络ID 最小长度：36 最大长度：36 publicip_pool_name String 功能说明：弹性公网IP的网络类型， 包括公共池类型，如5_bgp/5_sbgp...，和用户购买的专属池。专属池见publcip_pool相关接口 最小长度：0 最大长度：128 alias String 功能说明：弹性公网IP别名 最小长度：0 最大长度：255 public_border_group String 功能说明：中心还是边缘。中心CENTER，边缘为各边缘az名称 最小长度：0 最大长度：64 表7 VnicResp 参数 参数类型 描述 private_ip_address String 功能说明：PORT的内网地址 最小长度：0 最大长度：36 device_id String 功能说明：PORT的device_id 约束：存在PORT时，此字段associate_instance_id相同，都为实例ID 最小长度：0 最大长度：36 device_owner String 功能说明：PORT的device_owner 约束：存在PORT时，此字段和associate_instance_type都可区分实例类型 最小长度：0 最大长度：36 vtep String 功能说明：VTEP IP 最小长度：0 最大长度：36 vni String 功能说明：VXLAN ID 最小长度：0 最大长度：36 vpc_id String 功能说明：PORT所在VPC的ID 最小长度：36 最大长度：36 port_id String 功能说明：PORT的唯一标识 最小长度：36 最大长度：36 port_profile String 功能说明：端口profile信息 最小长度：0 最大长度：256 mac String 功能说明：PORT的MAC信息 最小长度：0 最大长度：36 instance_id String 功能说明：PORT的使用者，不同于device_id的归属者。举例：vip port的device_owner为vip，但是这个port实际使用者可能是虚机或其他 最小长度：0 最大长度：36 instance_type String 功能说明：标记PORT使用者，与instance_id组合使用 最小长度：0 最大长度：36 表8 BandwidthResp 参数 参数类型 描述 id String 功能说明：带宽ID 最小长度：36 最大长度：36 size Integer 功能说明：带宽大小 最小值：0 最大值：2000 share_type String 功能说明：类型 "WHOLE"为共享带宽，"PER"为独占带宽 最小长度：0 最大长度：36 charge_mode String 功能说明：带宽计费模式 最小长度：0 最大长度：36 name String 功能说明：带宽名称 最小长度：0 最大长度：255 billing_info String 功能说明：带宽的订单信息 最小长度：0 最大长度：1024

请求示例 多个不同的弹性公网IP加入到共享带宽，共享带宽的id必须相同 POST /v3/{project_id}/eip/publicips/attach-share-bandwidth { "publicips" : [ { "bandwidth_id" : "e6af636c-ea79-4c20-ba2f-402057ba7886", "publicip_id" : "99c8a2df-9e90-48df-9132-e2216e659459" }, { "bandwidth_id" : "e6af636c-ea79-4c20-ba2f-402057ba7886", "publicip_id" : "7b484d78-550a-4e92-8363-a34b5194ddcb" } ] }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 publicips 否 Array of BatchAttachSharebwDict objects 功能说明：共享带宽数据 约束：共享带宽批量加入多个弹性公网IP时，请求参数publicips中的bandwidth_id必须为同一个共享带宽的id 数组长度：1 - 50 表3 BatchAttachSharebwDict 参数 是否必选 参数类型 描述 bandwidth_id 否 String 共享带宽的id 最小长度：36 最大长度：36 publicip_id 否 String 弹性公网IP ID 最小长度：36 最大长度：36

响应示例 状态码： 200 GET和PUT操作正常返回 { "bandwidths" : [ { "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c", "enterprise_project_id" : "0", "billing_info" : "CS1712121146TSQOJ:0616e2a5dc9f4985ba52ea8c0c7e273c:southchina:35f2b308f5d64441a6fa7999fbcd4321", "size" : 5, "share_type" : "PER", "bandwidth_type" : "bgp", "publicip_info" : [ { "publicip_id" : "80d5b82e-43b9-4f82-809a-37bec5793bd4", "ip_version" : 4, "publicip_type" : "5_bgp", "publicip_address" : "161.xx.xx.10" } ], "name" : "ddddd", "charge_mode" : "bandwidth", "enable_bandwidth_rules" : false, "rule_quota" : 0, "bandwidth_rules" : [ ], "id" : "a79fd11a-047b-4f5b-8f12-99c178cc780a", "status" : "NORMAL" }, { "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c", "enterprise_project_id" : "0", "size" : 6, "share_type" : "PER", "bandwidth_type" : "bgp", "publicip_info" : [ { "publicip_id" : "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0", "ip_version" : 4, "publicip_type" : "5_bgp", "publicip_address" : "161.xx.xx.9" } ], "name" : "22212", "enable_bandwidth_rules" : false, "rule_quota" : 0, "bandwidth_rules" : [ ], "charge_mode" : "bandwidth", "id" : "3fa5b383-5a73-4dcb-a314-c6128546d855", "status" : "NORMAL" }, { "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c", "enterprise_project_id" : "0", "size" : 5, "share_type" : "PER", "bandwidth_type" : "bgp", "publicip_info" : [ { "publicip_id" : "4ca21961-8e52-4ff4-b9c5-af2dcc2c7b50", "ip_version" : 4, "publicip_type" : "5_bgp", "publicip_address" : "161.xx.xx.13" } ], "name" : "2222", "enable_bandwidth_rules" : false, "rule_quota" : 0, "bandwidth_rules" : [ ], "charge_mode" : "bandwidth", "id" : "f54e0df7-422d-4ab6-8d65-fd436151479c", "status" : "NORMAL" } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 bandwidths Array of BandwidthResp objects 带宽列表对象 表4 BandwidthResp 参数 参数类型 描述 bandwidth_type String 功能说明：带宽类型，共享带宽默认为share。 取值范围：share,share_sbgp share: 通用共享带宽 share_sbgp: 静态共享带宽 最小长度：1 最大长度：36 billing_info String 功能说明：账单信息，如果billinginfo不为空，说明是包周期的带宽 最小长度：0 最大长度：255 charge_mode String 功能说明：按流量计费,按带宽计费还是按增强型95计费。 取值范围：bandwidth（按带宽计费），traffic（按流量计费），95peak_plus（按增强型95计费），不返回或者为空时表示是bandwidth。 约束：只有共享带宽支持95peak_plus（按增强型95计费），按增强型95计费时需要指定保底百分比，默认是20%。 枚举值： bandwidth traffic 95peak_plus id String 功能说明：带宽唯一标识 最大长度：36 name String 功能说明：带宽名称 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点） 最小长度：1 最大长度：64 publicip_info Array of PublicipInfoResp objects 功能说明：带宽对应的弹性公网IP信息 约束：WHOLE类型的带宽支持多个EIP，PER类型的带宽只能对应一个EIP share_type String 功能说明：共享带宽类型，标识是否是共享带宽 取值范围：PER，WHOLE（PER为独占带宽，WHOLE是共享带宽）。 枚举值： WHOLE PER size Integer 功能说明：带宽大小 取值范围：默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。 tenant_id String 功能说明：用户所属租户ID 最大长度：36 enterprise_project_id String 企业项目ID。最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。 创建弹性公网IP时，给弹性公网IP绑定企业项目ID。 不指定该参数时，默认值是 0 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 最大长度：36 status String 功能说明：带宽的状态 取值范围： FREEZED：冻结 NORMAL：正常 枚举值： FREEZED NORMAL enable_bandwidth_rules Boolean 功能说明：是否开启企业级qos 取值范围：true/false，该字段仅在上海1局点返回 rule_quota Integer 功能说明：带宽支持的最大分组规则数。（该字段仅在上海1局点返回） 最小值：0 最大值：1024 bandwidth_rules Array of BandWidthRules objects 功能说明：带宽规则对象（该字段仅在上海1局点返回） created_at String 功能说明：资源创建时间，UTC时间 格式： yyyy-MM-ddTHH:mm:ss updated_at String 功能说明：资源更新时间，UTC时间 格式： yyyy-MM-ddTHH:mm:ss public_border_group String 功能说明：表示中心站点资源或者边缘站点资源 取值范围： center、边缘站点名称 约束：共享带宽只能绑定与该字段相同的publicip 最小长度：1 最大长度：64 表5 BandWidthRules 参数 参数类型 描述 id String 功能说明：带宽规则ID 最大长度：36 name String 功能说明：带宽规则名称 最小长度：0 最大长度：64 admin_state_up Boolean 功能说明：配置状态，为False时配置不生效。 egress_size Integer 功能说明：出网带宽最大值，单位Mbps 取值范围[0,n]，其中n为所属带宽的带宽大小（size字段）。0表示设置为最大带宽 最小值：0 缺省值：0 egress_guarented_size Integer 功能说明：出网保障带宽大小，单位Mbps 取值范围[0,x]，其中x为所属带宽剩余的保障额 最小值：0 缺省值：0 publicip_info Array of PublicipInfoResp objects 功能说明：带宽对应的弹性公网IP信息 约束：WHOLE类型的带宽支持多个弹性公网IP，PER类型的带宽只能对应一个弹性公网IP 表6 PublicipInfoResp 参数 参数类型 描述 publicip_address String 功能说明：功能说明：EIP或者IPv6端口的地址 最大长度：15 publicip_id String 功能说明：带宽对应的EIP或者IPv6端口的唯一标识 最大长度：36 publicip_type String 功能说明：EIP的类型 取值范围：5_bgp（全动态BGP），5_sbgp（静态BGP），5_youxuanbgp（优选BGP） 华南-广州：5_bgp、5_sbgp 华东-上海一：5_bgp、5_sbgp 华东-上海二：5_bgp、5_sbgp 华北-北京一：5_bgp、5_sbgp 中国-香港：5_bgp、5_youxuanbgp 亚太-曼谷：5_bgp 亚太-新加坡：5_bgp 非洲-约翰内斯堡：5_bgp 西南-贵阳一：5_sbgp 华北-北京四：5_bgp、5_sbgp 拉美-圣地亚哥：5_bgp 拉美-圣保罗一：5_bgp 拉美-墨西哥城一：5_bgp 拉美-布宜诺斯艾利一：5_bgp 拉美-利马一：5_bgp 拉美-圣地亚哥二： 5_bgp 约束： 必须是系统具体支持的类型。 publicip_id为IPv4端口，所以"type"字段未给定时，默认为5_bgp。 最大长度：36 publicipv6_address String 功能说明：IPv4时无此字段，IPv6时为申请到的EIP地址 最大长度：39 ip_version Integer 功能说明：IP版本信息 取值范围： 4：IPv4 6：开启NAT64能力 枚举值： 4 6

URI GET /v1/{project_id}/bandwidths 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取项目ID请参见获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 marker 否 String 功能说明：取值为上一页数据的最后一条记录的id，为空时为查询第一页 最大长度：36 limit 否 Integer 功能说明：每页返回的个数 取值范围：0~intmax 最小值：0 enterprise_project_id 否 String 功能说明：企业项目ID。可以使用该字段过滤某个企业项目下的EIP。 取值范围：最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。“0”表示默认企业项目。若需要查询当前用户所有企业项目绑定的弹性公网IP，请传参all_granted_eps。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 share_type 否 String 功能说明：带宽类型，标识是否是共享带宽 取值范围：WHOLE，PER WHOLE：共享带宽 PER：独享带宽 枚举值： WHOLE PER

监控指标 表1 弹性公网IP和带宽支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） upstream_bandwidth 出网带宽 该指标用于统计测试对象出云平台的网络速度（原指标为上行带宽）。 单位：比特/秒 ≥ 0 bit/s 带宽或弹性公网IP 1分钟 downstream_bandwidth 入网带宽 该指标用于统计测试对象入云平台的网络速度（原指标为下行带宽）。 单位：比特/秒 ≥ 0 bit/s 带宽或弹性公网IP 1分钟 upstream_bandwidth_usage 出网带宽使用率 该指标用于统计测量对象出云平台的带宽使用率，以百分比为单位。 出网带宽使用率=出网带宽指标/购买的带宽大小 0-100% 带宽或弹性公网IP 1分钟 downstream_bandwidth_usage 入网带宽使用率 该指标用于统计测量对象入云平台的带宽使用率，以百分比为单位。 入网带宽使用率=入网带宽指标/购买的带宽大小 0-100% 带宽或弹性公网IP 1分钟 up_stream 出网流量 该指标用于统计测试对象出云平台一分钟内累积的网络流量平均值（原指标为上行流量）。 单位：字节 ≥ 0 bytes 带宽或弹性公网IP 1分钟 down_stream 入网流量 该指标用于统计测试对象入云平台一分钟内累积的网络流量平均值（原指标为下行流量）。 单位：字节 ≥ 0 bytes 带宽或弹性公网IP 1分钟

请求示例 弹性公网IP批量移出共享带宽，弹性公网IP通过请求体中的publicip_id传入，移出后弹性公网IP的宽带信息通过bandwidth参数传入 POST /v3/{project_id}/eip/publicips/detach-share-bandwidth { "publicips" : [ { "publicip_id" : "99c8a2df-9e90-48df-9132-e2216e659459", "bandwidth" : { "name" : "bandwidth-test", "size" : 5, "charge_mode" : "bandwidth" } }, { "publicip_id" : "7b484d78-550a-4e92-8363-a34b5194ddcb", "bandwidth" : { "name" : "bandwidth-test", "size" : 5, "charge_mode" : "bandwidth" } } ] }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 publicips Array of BatchPublicipResp objects 弹性公网IP对象 request_id String 本次请求编号 表6 BatchPublicipResp 参数 参数类型 描述 statusCode Integer 响应码 publicip PublicipResp object 弹性公网IP对象 表7 PublicipResp 参数 参数类型 描述 id String 功能说明：弹性公网IP的唯一标识 最小长度：36 最大长度：36 project_id String 功能说明：项目ID 最小长度：32 最大长度：32 ip_version Integer 功能说明: 弹性公网IP版本号 取值范围: 4、6，6为开启NAT64能力 4表示公网IP地址为public_ip_address地址 6表示公网IP地址为public_ipv6_address地址 最小值：4 最大值：6 枚举值： 4 6 public_ip_address String 功能说明: 弹性公网IPv4地址 最小长度：0 最大长度：64 public_ipv6_address String 功能说明: 弹性公网IPv6地址 最小长度：0 最大长度：64 status String 功能说明：弹性公网IP的状态 取值范围：FREEZED，DOWN，ACTIVE，ERROR。 FREEZED表示弹性公网IP处于冻结状态 DOWN表示弹性公网IP未绑定实例 ACTIVE表示弹性公网IP绑定实例，正在使用中 ERROR表示弹性公网IP状态异常 最小长度：0 最大长度：16 枚举值： FREEZED DOWN ACTIVE ERROR description String 功能说明：弹性公网IP的描述信息 约束：用户以自定义方式标识资源，系统不感知 最小长度：0 最大长度：1024 created_at String 功能说明：弹性公网IP的创建时间 约束：UTC时间格式（2018-12-25T10:07:24Z） 最小长度：0 最大长度：64 updated_at String 功能说明：弹性公网IP最近的更新时间 约束：UTC时间格式（2018-12-25T10:09:20Z） 最小长度：0 最大长度：64 type String 功能说明：弹性公网IP的类型 取值范围：EIP，DUALSTACK 最小长度：0 最大长度：36 枚举值： EIP DUALSTACK vnic VnicResp object 功能说明：弹性公网IP绑定实例有PORT时，PORT的相关信息 约束：若绑定的实例不依赖PORT，该对象为null bandwidth BandwidthResp object 功能说明：弹性公网IP绑定的带宽信息 enterprise_project_id String 功能说明：弹性公网IP的企业项目ID 最小长度：32 最大长度：32 billing_info String 功能说明：弹性公网IP的订单信息 约束：包周期才会有订单信息，按需资源此字段为空 最小长度：0 最大长度：1024 lock_status String 功能说明：记录弹性公网IP当前的冻结状态 约束：metadata类型，标识欠费冻结、公安冻结 最小长度：0 最大长度：36 associate_instance_type String 功能说明：弹性公网IP绑定的实例类型 取值范围：PORT、NATGW、ELB、ELBV1、VPN 最小长度：0 最大长度：36 枚举值： PORT NATGW ELB ELBV1 VPN associate_instance_id String 功能说明：弹性公网IP绑定的实例ID 最小长度：0 最大长度：36 publicip_pool_id String 功能说明：弹性公网IP所属网络的ID。publicip_pool_name对应的网络ID 最小长度：36 最大长度：36 publicip_pool_name String 功能说明：弹性公网IP的网络类型， 包括公共池类型，如5_bgp/5_sbgp...，和用户购买的专属池。专属池见publcip_pool相关接口 最小长度：0 最大长度：128 alias String 功能说明：弹性公网IP别名 最小长度：0 最大长度：255 public_border_group String 功能说明：中心还是边缘。中心CENTER，边缘为各边缘az名称 最小长度：0 最大长度：64 表8 VnicResp 参数 参数类型 描述 private_ip_address String 功能说明：PORT的内网地址 最小长度：0 最大长度：36 device_id String 功能说明：PORT的device_id 约束：存在PORT时，此字段associate_instance_id相同，都为实例ID 最小长度：0 最大长度：36 device_owner String 功能说明：PORT的device_owner 约束：存在PORT时，此字段和associate_instance_type都可区分实例类型 最小长度：0 最大长度：36 vtep String 功能说明：VTEP IP 最小长度：0 最大长度：36 vni String 功能说明：VXLAN ID 最小长度：0 最大长度：36 vpc_id String 功能说明：PORT所在VPC的ID 最小长度：36 最大长度：36 port_id String 功能说明：PORT的唯一标识 最小长度：36 最大长度：36 port_profile String 功能说明：端口profile信息 最小长度：0 最大长度：256 mac String 功能说明：PORT的MAC信息 最小长度：0 最大长度：36 instance_id String 功能说明：PORT的使用者，不同于device_id的归属者。举例：vip port的device_owner为vip，但是这个port实际使用者可能是虚机或其他 最小长度：0 最大长度：36 instance_type String 功能说明：标记PORT使用者，与instance_id组合使用 最小长度：0 最大长度：36 表9 BandwidthResp 参数 参数类型 描述 id String 功能说明：带宽ID 最小长度：36 最大长度：36 size Integer 功能说明：带宽大小 最小值：0 最大值：2000 share_type String 功能说明：类型 "WHOLE"为共享带宽，"PER"为独占带宽 最小长度：0 最大长度：36 charge_mode String 功能说明：带宽计费模式 最小长度：0 最大长度：36 name String 功能说明：带宽名称 最小长度：0 最大长度：255 billing_info String 功能说明：带宽的订单信息 最小长度：0 最大长度：1024

响应示例 状态码： 200 POST操作正常返回 { "publicips" : [ { "statusCode" : 200, "publicip" : { "alias" : "test", "associate_instance_id" : null, "associate_instance_type" : null, "bandwidth" : { "id" : "e6af636c-ea79-4c20-ba2f-402057ba7886", "size" : 5, "share_type" : "WHOLE", "charge_mode" : "traffic", "name" : "bandwidth-b8ff", "billing_info" : "" }, "billing_info" : null, "created_at" : "2020-07-10T10:10:18Z", "description" : "", "enterprise_project_id" : "0", "id" : "99c8a2df-9e90-48df-9132-e2216e659459", "ip_version" : 4, "lock_status" : null, "project_id" : "8d53f081ea24444aa95e2bfa942ef6ee", "public_border_group" : "center", "public_ip_address" : "10.246.165.44", "public_ipv6_address" : null, "publicip_pool_id" : "ece62314-858c-4793-a768-346efca42131", "publicip_pool_name" : "5_bgp", "status" : "ACTIVE", "type" : "EIP", "updated_at" : "2020-07-11T05:03:25Z", "vnic" : { "device_id" : "cc03e7f7-b820-4a2e-b243-8022daabf0cf", "device_owner" : "compute:br-iaas-odin1a", "instance_id" : "", "instance_type" : "", "mac" : "fa:16:3e:7a:5f:db", "port_id" : "fb68a8e1-b93e-4100-8735-6d6b0a6a0eb5", "port_profile" : "", "private_ip_address" : "192.168.3.222", "vni" : "435405", "vpc_id" : "ac17491b-0769-4d96-b883-6d6295f6afad", "vtep" : "18.8.152.158" } } }, { "statusCode" : 200, "publicip" : { "alias" : "test", "associate_instance_id" : null, "associate_instance_type" : null, "bandwidth" : { "id" : "e6af636c-ea79-4c20-ba2f-402057ba7886", "size" : 5, "share_type" : "WHOLE", "charge_mode" : "traffic", "name" : "bandwidth-b8ff", "billing_info" : "" }, "billing_info" : null, "created_at" : "2020-07-10T10:10:18Z", "description" : "", "enterprise_project_id" : "0", "id" : "7b484d78-550a-4e92-8363-a34b5194ddcb", "ip_version" : 4, "lock_status" : null, "project_id" : "8d53f081ea24444aa95e2bfa942ef6ee", "public_border_group" : "center", "public_ip_address" : "10.246.165.45", "public_ipv6_address" : null, "publicip_pool_id" : "ece62314-858c-4793-a768-346efca42131", "publicip_pool_name" : "5_bgp", "status" : "ACTIVE", "type" : "EIP", "updated_at" : "2020-07-11T05:03:25Z", "vnic" : { "device_id" : "cc03e7f7-b820-4a2e-b243-8022daabf0dd", "device_owner" : "compute:br-iaas-odin1a", "instance_id" : "", "instance_type" : "", "mac" : "fa:16:3e:7a:5f:cc", "port_id" : "fb68a8e1-b93e-4100-8735-6d6b0a6a0eb6", "port_profile" : "", "private_ip_address" : "192.168.3.221", "vni" : "435405", "vpc_id" : "ac17491b-0769-4d96-b883-6d6295f6afad", "vtep" : "18.8.152.158" } } } ], "request_id" : "db4b975a79d1da86dda3d02054f11e16" }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 publicips 否 Array of publicips objects 共享带宽批量移出弹性公网IP请求对象 数组长度：1 - 50 表3 publicips 参数 是否必选 参数类型 描述 publicip_id 是 String 功能说明：EIP ID 缺省值：{} 最小长度：0 最大长度：255 bandwidth 是 DetachSharedbwDict object 弹性公网IP移出共享带宽后带宽的参数 表4 DetachSharedbwDict 参数 是否必选 参数类型 描述 name 否 String 功能说明：带宽名称 最小长度：0 最大长度：255 size 是 Integer 功能说明：带宽大小 最小值：0 最大值：2000 charge_mode 是 String 功能说明：带宽计费模式 最小长度：0 最大长度：36

响应示例 状态码： 200 GET操作正常返回 { "publicip" : { "created_at" : "2022-03-17T09:46:22Z", "updated_at" : "2022-03-30T02:46:04Z", "lock_status" : null, "allow_share_bandwidth_types" : [ "bgp", "sbgp", "share", "share_yidongdanxian", "share_youxuan" ], "id" : "006343a1-32bf-4361-958a-efd158153dd0", "alias" : null, "project_id" : "060576787a80d5762fa2c00f07ddfcf4", "ip_version" : 4, "public_ip_address" : "88.88.1.141", "public_ipv6_address" : null, "status" : "DOWN", "description" : "", "enterprise_project_id" : "0", "billing_info" : null, "type" : "EIP", "vnic" : { "private_ip_address" : "172.16.1.235", "device_id" : "", "device_owner" : "", "vpc_id" : "1c30f428-9741-48b2-a788-0b2f359705eb", "port_id" : "22d3576d-c042-4f3d-8c7c-1330a2724627", "mac" : "fa:16:3e:3a:22:66", "vtep" : null, "vni" : null, "instance_id" : "", "instance_type" : "", "port_profile" : null }, "bandwidth" : { "id" : "149ff19b-5de4-4436-958f-2eca39952e93", "size" : 100, "share_type" : "PER", "charge_mode" : "traffic", "name" : "bandwidth-xym-br-eqos", "billing_info" : "" }, "associate_instance_type" : "PORT", "associate_instance_id" : "22d3576d-c042-4f3d-8c7c-1330a2724627", "publicip_pool_id" : "9af5f2e5-1765-4b86-b342-ece52e785c8b", "publicip_pool_name" : "5_union", "public_border_group" : "center", "tags" : [ "key=value" ] }, "request_id" : "ce1a33a85d2e105040497a21bbe58c26" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 request_id String 本次请求的编号 最小长度：0 最大长度：36 publicip PublicipSingleShowResp object 功能说明：弹性公网IP对象 表4 PublicipSingleShowResp 参数 参数类型 描述 id String 功能说明：弹性公网IP唯一标识 最小长度：0 最大长度：36 project_id String 功能说明：项目ID 最小长度：0 最大长度：32 ip_version Integer 功能说明：IP版本信息 取值范围： 4：公网IP地址为public_ip_address地址 6：公网IP地址为public_ipv6_address地址 枚举值： 4 6 public_ip_address String 功能说明：弹性公网IP或者IPv6端口的地址 最小长度：0 最大长度：36 public_ipv6_address String 功能说明：IPv4时无此字段，IPv6时为申请到的弹性公网IP地址 最小长度：0 最大长度：64 network_type String 功能说明：弹性公网IP的网络类型。废弃，功能由publicip_pool_name继承，默认不显示 最小长度：0 最大长度：64 status String 功能说明：弹性公网IP的状态 取值范围： FREEZED：冻结 BIND_ERROR：绑定失败 BINDING：绑定中 PENDING_DELETE：释放中 PENDING_CREATE：创建中 NOTIFYING：创建中 NOTIFY_DELETE：释放中 PENDING_UPDATE：更新中 DOWN：未绑定 ACTIVE：绑定 ELB：绑定ELB VPN：绑定VPN ERROR：失败 最小长度：0 最大长度：64 枚举值： FREEZED BIND_ERROR BINDING PENDING_DELETE PENDING_CREATE NOTIFYING NOTIFY_DELETE PENDING_UPDATE DOWN ACTIVE ELB VPN ERROR description String 功能说明：弹性公网IP描述信息 约束：用户以自定义方式标识资源，系统不感知 最小长度：0 最大长度：256 public_border_group String 功能说明：表示中心站点资源或者边缘站点资源 取值范围： center、边缘站点名称 约束：publicip只能绑定该字段相同的资源 最小长度：1 最大长度：64 created_at String 功能说明：资源创建UTC时间 格式：yyyy-MM-ddTHH:mm:ssZ 最小长度：0 最大长度：64 updated_at String 功能说明：资源更新UTC时间 格式：yyyy-MM-ddTHH:mm:ssZ 最小长度：0 最大长度：64 type String 功能说明：弹性公网IP类型 最小长度：1 最大长度：36 枚举值： EIP DUALSTACK vnic VnicInfo object 功能说明：公网IP绑定实例有PORT时，PORT的相关信息 约束：若绑定的实例不依赖PORT，该对象为null bandwidth PublicipBandwidthInfo object 功能说明：公网IP绑定带宽信息 enterprise_project_id String 功能说明：企业项目ID。最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。创建弹性公网IP时,给弹性公网IP绑定企业项目ID。 最小长度：0 最大长度：36 billing_info String 功能说明：公网IP的订单信息 约束：包周期才会有订单信息，按需资源此字段为空 最小长度：0 最大长度：256 lock_status String 功能说明：记录公网IP当前的冻结状态 约束：metadata类型，标识欠费冻结、公安冻结 取值范围： police locked 最小长度：0 最大长度：64 associate_instance_type String 功能说明：公网IP绑定的实例类型 取值范围： PORT NATGW ELB ELBV1 VPN 最小长度：0 最大长度：64 枚举值： PORT NATGW ELB ELBV1 VPN associate_instance_id String 功能说明：公网IP绑定的实例ID 最小长度：0 最大长度：36 publicip_pool_id String 功能说明：公网IP所属网络的ID，publicip_pool_name对应的网络ID 最小长度：0 最大长度：36 publicip_pool_name String 功能说明：弹性公网IP的网络类型, 包括公共池类型，如5_bgp/5_sbgp...，和用户购买的专属池。 专属池见publcip_pool相关接口 最小长度：0 最大长度：64 alias String 功能说明：弹性公网IP名称 最小长度：0 最大长度：64 profile ProfileInfo object 功能说明：公网IP、元数据。（默认不显示） fake_network_type Boolean 功能说明：该字段仅仅用于表示eip的bgp类型是否是真实的静态sbgp * 1，如果为true，则该eip可以切换bgp类型 * 2； 如果为false，则该eip不可以切换bgp类型。（默认不显示） 枚举值： true false tags Array of strings 功能说明：用户标签。（默认不显示） 数组长度：0 - 9999 associate_instance_metadata String 功能说明：记录实例的更上一层归属。例如associate_instance_type为PORT，此字段记录PORT的device_id和device_owner信息。仅有限场景记录。（默认不显示） 最小长度：1 最大长度：64 associate_mode String 功能说明：开启支持直通模式后展示，表示直通模式的标识。（默认不显示） 最小长度：1 最大长度：36 allow_share_bandwidth_types Array of strings 功能说明：表示此publicip可以加入的共享带宽类型列表，如果为空列表，则表示该 publicip不能加入任何共享带宽 约束：publicip只能加入到有该带宽类型的共享带宽中 最大长度：64 数组长度：0 - 9999 cascade_delete_by_instance Boolean 功能说明：表示该eip是否支持与实例同步删除。（默认不显示） 表5 VnicInfo 参数 参数类型 描述 private_ip_address String 功能说明：私网IP地址 最小长度：0 最大长度：36 device_id String 功能说明：端口所属设备ID 约束：不支持设置和更新,由系统自动维护 最小长度：0 最大长度：36 device_owner String 功能说明：设备所属 取值范围：合法设备所属 network:dhcp network:VIP_PORT network:router_interface_distributed network:router_centralized_snat 约束：不支持设置和更新,由系统自动维护 最小长度：0 最大长度：64 vpc_id String 功能说明：虚拟私有云ID 最小长度：0 最大长度：36 port_id String 功能说明：端口ID 最小长度：0 最大长度：36 port_profile String 功能说明：端口profile信息 最小长度：0 最大长度：256 mac String 功能说明：端口MAC地址 约束：由系统分配,不支持指定 最小长度：0 最大长度：64 vtep String 功能说明：VTEP IP 最小长度：0 最大长度：36 vni String 功能说明：VXLAN ID 最小长度：0 最大长度：36 instance_id String 功能说明：端口所属实例ID,例如RDS实例ID 约束：不支持设置和更新,由系统自动维护 最小长度：0 最大长度：36 instance_type String 功能说明：端口所属实例类型,例如“RDS” 约束：不支持设置和更新,由系统自动维护 最小长度：0 最大长度：36 表6 PublicipBandwidthInfo 参数 参数类型 描述 id String 功能描述：带宽ID 最小长度：0 最大长度：36 size Integer 功能描述：带宽大小 取值范围：默认5Mbit/s~2000Mbit/s 最小值：0 最大值：99999 share_type String 功能说明：带宽类型，标识是否是共享带宽 取值范围： PER：独享带宽 WHOLE：共享带宽 约束：其中IPv6暂不支持WHOLE类型带宽。 最小长度：0 最大长度：36 charge_mode String 功能说明：按流量计费还是按带宽计费 取值范围： bandwidth：按带宽计费 traffic：按流量计费 95peak_plus：按增强型95计费 最小长度：0 最大长度：36 name String 功能说明：带宽名称 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-(中划线)、.(点) 最小长度：0 最大长度：64 billing_info String 功能说明：账单信息。如果billinginfo不为空，说明是包周期的带宽 最小长度：0 最大长度：256 表7 ProfileInfo 参数 参数类型 描述 local_network_port String 功能说明：公网IP附属的5_xxx网络（如5_bgp）中的port_id 最小长度：0 最大长度：36 standalone Boolean 功能说明：标识公网IP是否是和虚机一起创建的。true-独立创建；false-和虚机一起创建 notify_status String 功能说明：云服务标识公网IP创建进度, EIP服务内部使用 最小长度：0 最大长度：36 枚举值： PENDING_CREATE PENDING_UPDATE NOTIFYING NOTIFYED NOTIFY_DELETE create_time String 功能说明：公网IP创建时间 最小长度：0 最大长度：64 fake_network_type Boolean 功能说明：该字段仅仅用于表示eip的bgp类型是否是真实的静态sbgp * 1， 如果为true，则该eip可以切换bgp类型 * 2； 如果为false，则该eip不可以切换bgp类型 枚举值： true false create_source String 功能说明：标识IP是和哪类资源一起购买的 最小长度：0 最大长度：36 枚举值： ecs ecs_id String 功能说明：标识和公网IP一起购买的ecs的id 最小长度：0 最大长度：36 lock_status String 功能说明：公网IP加锁状态, eg："POLICE,LOCKED"。POLICE-公安冻结；LOCKED-普通冻结；普通冻结细分状态：ARREAR-欠费；DELABLE-可删除； 最小长度：0 最大长度：36 freezed_status String 功能说明：公网IP冻结状态。 最小长度：0 最大长度：36 枚举值： FREEZED UNFREEZED bandwith_info BandwidthInfoResp object 功能说明：公网IP绑定的带宽信息 表8 BandwidthInfoResp 参数 参数类型 描述 bandwidth_name String 功能说明：带宽名称 最小长度：0 最大长度：255 bandwidth_number Integer 功能说明：带宽大小 最小值：0 最大值：2000 bandwidth_type String 功能说明：带宽类型 最小长度：0 最大长度：36 枚举值： PER WHOLE bandwidth_id String 功能说明：带宽id 最小长度：36 最大长度：36

URI GET /v3/{project_id}/eip/publicips/{publicip_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID 最小长度：0 最大长度：32 publicip_id 是 String 弹性公网IP的ID 最小长度：0 最大长度：36 表2 Query参数 参数 是否必选 参数类型 描述 fields 否 Array 功能说明：查询字段，形式为"fields=id&fields=owner&..." 支持字段：id/project_id/ip_version/type/public_ip_address/public_ipv6_address/network_type/status/description/created_at/updated_at/vnic/bandwidth/associate_instance_type/associate_instance_id/lock_status/billing_info/tags/enterprise_project_id/publicip_pool_name/allow_share_bandwidth_types/alias/publicip_pool_id/public_border_group 数组长度：0 - 999

响应示例 状态码： 200 GET和PUT操作正常返回 { "bandwidth" : { "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c", "enterprise_project_id" : "0", "size" : 10, "share_type" : "PER", "bandwidth_type" : "bgp", "publicip_info" : [ { "publicip_id" : "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0", "ip_version" : 4, "publicip_type" : "5_bgp", "publicip_address" : "161.xx.xx.9" } ], "name" : "bandwidth123", "charge_mode" : "bandwidth", "enable_bandwidth_rules" : false, "rule_quota" : 0, "bandwidth_rules" : [ ], "id" : "3fa5b383-5a73-4dcb-a314-c6128546d855", "billing_info" : "", "status" : "NORMAL" } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 bandwidth BandwidthResp object 带宽对象 表5 BandwidthResp 参数 参数类型 描述 bandwidth_type String 功能说明：带宽类型，共享带宽默认为share。 取值范围：share,share_sbgp share: 通用共享带宽 share_sbgp: 静态共享带宽 最小长度：1 最大长度：36 billing_info String 功能说明：账单信息，如果billinginfo不为空，说明是包周期的带宽 最小长度：0 最大长度：255 charge_mode String 功能说明：按流量计费,按带宽计费还是按增强型95计费。 取值范围：bandwidth（按带宽计费），traffic（按流量计费），95peak_plus（按增强型95计费），不返回或者为空时表示是bandwidth。 约束：只有共享带宽支持95peak_plus（按增强型95计费），按增强型95计费时需要指定保底百分比，默认是20%。 枚举值： bandwidth traffic 95peak_plus id String 功能说明：带宽唯一标识 最大长度：36 name String 功能说明：带宽名称 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点） 最小长度：1 最大长度：64 publicip_info Array of PublicipInfoResp objects 功能说明：带宽对应的弹性公网IP信息 约束：WHOLE类型的带宽支持多个EIP，PER类型的带宽只能对应一个EIP share_type String 功能说明：共享带宽类型，标识是否是共享带宽 取值范围：PER，WHOLE（PER为独占带宽，WHOLE是共享带宽）。 枚举值： WHOLE PER size Integer 功能说明：带宽大小 取值范围：默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。 tenant_id String 功能说明：用户所属租户ID 最大长度：36 enterprise_project_id String 企业项目ID。最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。 创建弹性公网IP时，给弹性公网IP绑定企业项目ID。 不指定该参数时，默认值是 0 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 最大长度：36 status String 功能说明：带宽的状态 取值范围： FREEZED：冻结 NORMAL：正常 枚举值： FREEZED NORMAL enable_bandwidth_rules Boolean 功能说明：是否开启企业级qos 取值范围：true/false，该字段仅在上海1局点返回 rule_quota Integer 功能说明：带宽支持的最大分组规则数。（该字段仅在上海1局点返回） 最小值：0 最大值：1024 bandwidth_rules Array of BandWidthRules objects 功能说明：带宽规则对象（该字段仅在上海1局点返回） created_at String 功能说明：资源创建时间，UTC时间 格式： yyyy-MM-ddTHH:mm:ss updated_at String 功能说明：资源更新时间，UTC时间 格式： yyyy-MM-ddTHH:mm:ss public_border_group String 功能说明：表示中心站点资源或者边缘站点资源 取值范围： center、边缘站点名称 约束：共享带宽只能绑定与该字段相同的publicip 最小长度：1 最大长度：64 表6 BandWidthRules 参数 参数类型 描述 id String 功能说明：带宽规则ID 最大长度：36 name String 功能说明：带宽规则名称 最小长度：0 最大长度：64 admin_state_up Boolean 功能说明：配置状态，为False时配置不生效。 egress_size Integer 功能说明：出网带宽最大值，单位Mbps 取值范围[0,n]，其中n为所属带宽的带宽大小（size字段）。0表示设置为最大带宽 最小值：0 缺省值：0 egress_guarented_size Integer 功能说明：出网保障带宽大小，单位Mbps 取值范围[0,x]，其中x为所属带宽剩余的保障额 最小值：0 缺省值：0 publicip_info Array of PublicipInfoResp objects 功能说明：带宽对应的弹性公网IP信息 约束：WHOLE类型的带宽支持多个弹性公网IP，PER类型的带宽只能对应一个弹性公网IP 表7 PublicipInfoResp 参数 参数类型 描述 publicip_address String 功能说明：功能说明：EIP或者IPv6端口的地址 最大长度：15 publicip_id String 功能说明：带宽对应的EIP或者IPv6端口的唯一标识 最大长度：36 publicip_type String 功能说明：EIP的类型 取值范围：5_bgp（全动态BGP），5_sbgp（静态BGP），5_youxuanbgp（优选BGP） 华南-广州：5_bgp、5_sbgp 华东-上海一：5_bgp、5_sbgp 华东-上海二：5_bgp、5_sbgp 华北-北京一：5_bgp、5_sbgp 中国-香港：5_bgp、5_youxuanbgp 亚太-曼谷：5_bgp 亚太-新加坡：5_bgp 非洲-约翰内斯堡：5_bgp 西南-贵阳一：5_sbgp 华北-北京四：5_bgp、5_sbgp 拉美-圣地亚哥：5_bgp 拉美-圣保罗一：5_bgp 拉美-墨西哥城一：5_bgp 拉美-布宜诺斯艾利一：5_bgp 拉美-利马一：5_bgp 拉美-圣地亚哥二： 5_bgp 约束： 必须是系统具体支持的类型。 publicip_id为IPv4端口，所以"type"字段未给定时，默认为5_bgp。 最大长度：36 publicipv6_address String 功能说明：IPv4时无此字段，IPv6时为申请到的EIP地址 最大长度：39 ip_version Integer 功能说明：IP版本信息 取值范围： 4：IPv4 6：开启NAT64能力 枚举值： 4 6

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 bandwidth 是 UpdateBandwidthOption object 带宽对象 表3 UpdateBandwidthOption 参数 是否必选 参数类型 描述 name 否 String 取值范围：1-64，支持数字、字母、中文、_(下划线)、-（中划线），为空表示不修改名称 功能说明：带宽名称 约束：name、size必须有一个参数有值 最小长度：1 最大长度：64 size 否 Integer 功能说明：带宽大小，单位Mbit/s。 取值范围：默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。 约束：share_type是PER，该参数必须带，如果share_type是WHOLE并且id有值，该参数会忽略。 注意：调整带宽时的最小单位会根据带宽范围不同存在差异。 小于等于300Mbit/s：默认最小单位为1Mbit/s。 300Mbit/s~1000Mbit/s：默认最小单位为50Mbit/s。 大于1000Mbit/s：默认最小单位为500Mbit/s。 charge_mode 否 String 功能说明：按流量计费,按带宽计费还是按增强型95计费。 取值范围：bandwidth，traffic，95peak_plus（按增强型95计费）不返回或者为空时表示是bandwidth。 约束：只有共享带宽支持95peak_plus（按增强型95计费），按增强型95计费时需要指定保底百分比，默认是20%。 枚举值： bandwidth traffic 95peak_plus

响应示例 状态码： 200 POST操作正常返回 { "bandwidth" : { "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c", "enterprise_project_id" : "b261ac1f-2489-4bc7-b31b-c33c3346a439", "billing_info" : "", "size" : 10, "share_type" : "WHOLE", "bandwidth_type" : "share", "publicip_info" : [ ], "name" : "bandwidth123", "charge_mode" : "bandwidth", "enable_bandwidth_rules" : false, "rule_quota" : 0, "bandwidth_rules" : [ ], "id" : "3fa5b383-5a73-4dcb-a314-c6128546d855", "status" : "NORMAL" } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 bandwidth BandwidthResp object 带宽对象 表5 BandwidthResp 参数 参数类型 描述 bandwidth_type String 功能说明：带宽类型，共享带宽默认为share。 取值范围：share,share_sbgp share: 通用共享带宽 share_sbgp: 静态共享带宽 最小长度：1 最大长度：36 billing_info String 功能说明：账单信息，如果billinginfo不为空，说明是包周期的带宽 最小长度：0 最大长度：255 charge_mode String 功能说明：按流量计费,按带宽计费还是按增强型95计费。 取值范围：bandwidth（按带宽计费），traffic（按流量计费），95peak_plus（按增强型95计费），不返回或者为空时表示是bandwidth。 约束：只有共享带宽支持95peak_plus（按增强型95计费），按增强型95计费时需要指定保底百分比，默认是20%。 枚举值： bandwidth traffic 95peak_plus id String 功能说明：带宽唯一标识 最大长度：36 name String 功能说明：带宽名称 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点） 最小长度：1 最大长度：64 publicip_info Array of PublicipInfoResp objects 功能说明：带宽对应的弹性公网IP信息 约束：WHOLE类型的带宽支持多个EIP，PER类型的带宽只能对应一个EIP share_type String 功能说明：共享带宽类型，标识是否是共享带宽 取值范围：PER，WHOLE（PER为独占带宽，WHOLE是共享带宽）。 枚举值： WHOLE PER size Integer 功能说明：带宽大小 取值范围：默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。 tenant_id String 功能说明：用户所属租户ID 最大长度：36 enterprise_project_id String 企业项目ID。最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。 创建弹性公网IP时，给弹性公网IP绑定企业项目ID。 不指定该参数时，默认值是 0 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 最大长度：36 status String 功能说明：带宽的状态 取值范围： FREEZED：冻结 NORMAL：正常 枚举值： FREEZED NORMAL enable_bandwidth_rules Boolean 功能说明：是否开启企业级qos 取值范围：true/false，该字段仅在上海1局点返回 rule_quota Integer 功能说明：带宽支持的最大分组规则数。（该字段仅在上海1局点返回） 最小值：0 最大值：1024 bandwidth_rules Array of BandWidthRules objects 功能说明：带宽规则对象（该字段仅在上海1局点返回） created_at String 功能说明：资源创建时间，UTC时间 格式： yyyy-MM-ddTHH:mm:ss updated_at String 功能说明：资源更新时间，UTC时间 格式： yyyy-MM-ddTHH:mm:ss public_border_group String 功能说明：表示中心站点资源或者边缘站点资源 取值范围： center、边缘站点名称 约束：共享带宽只能绑定与该字段相同的publicip 最小长度：1 最大长度：64 表6 BandWidthRules 参数 参数类型 描述 id String 功能说明：带宽规则ID 最大长度：36 name String 功能说明：带宽规则名称 最小长度：0 最大长度：64 admin_state_up Boolean 功能说明：配置状态，为False时配置不生效。 egress_size Integer 功能说明：出网带宽最大值，单位Mbps 取值范围[0,n]，其中n为所属带宽的带宽大小（size字段）。0表示设置为最大带宽 最小值：0 缺省值：0 egress_guarented_size Integer 功能说明：出网保障带宽大小，单位Mbps 取值范围[0,x]，其中x为所属带宽剩余的保障额 最小值：0 缺省值：0 publicip_info Array of PublicipInfoResp objects 功能说明：带宽对应的弹性公网IP信息 约束：WHOLE类型的带宽支持多个弹性公网IP，PER类型的带宽只能对应一个弹性公网IP 表7 PublicipInfoResp 参数 参数类型 描述 publicip_address String 功能说明：功能说明：EIP或者IPv6端口的地址 最大长度：15 publicip_id String 功能说明：带宽对应的EIP或者IPv6端口的唯一标识 最大长度：36 publicip_type String 功能说明：EIP的类型 取值范围：5_bgp（全动态BGP），5_sbgp（静态BGP），5_youxuanbgp（优选BGP） 华南-广州：5_bgp、5_sbgp 华东-上海一：5_bgp、5_sbgp 华东-上海二：5_bgp、5_sbgp 华北-北京一：5_bgp、5_sbgp 中国-香港：5_bgp、5_youxuanbgp 亚太-曼谷：5_bgp 亚太-新加坡：5_bgp 非洲-约翰内斯堡：5_bgp 西南-贵阳一：5_sbgp 华北-北京四：5_bgp、5_sbgp 拉美-圣地亚哥：5_bgp 拉美-圣保罗一：5_bgp 拉美-墨西哥城一：5_bgp 拉美-布宜诺斯艾利一：5_bgp 拉美-利马一：5_bgp 拉美-圣地亚哥二： 5_bgp 约束： 必须是系统具体支持的类型。 publicip_id为IPv4端口，所以"type"字段未给定时，默认为5_bgp。 最大长度：36 publicipv6_address String 功能说明：IPv4时无此字段，IPv6时为申请到的EIP地址 最大长度：39 ip_version Integer 功能说明：IP版本信息 取值范围： 4：IPv4 6：开启NAT64能力 枚举值： 4 6