本文导读

功能介绍
调试
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 弹性公网IP EIP/ API参考/ API V3/ 弹性公网IP/ 查询弹性公网IP列表

查询弹性公网IP列表

更新时间：2025-06-27 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

查询用户当前局点全量弹性公网IP列表信息

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

URI

GET /v3/{project_id}/eip/publicips

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取项目ID请参见获取项目ID 最大长度：32

表2 Query参数
参数	是否必选	参数类型	描述
marker	否	String	功能说明：分页查询起始的资源ID，为空时为查询第一页最小长度：0 最大长度：36
offset	否	Integer	功能说明：分页查询起始的资源序号最小值：0 最大值：99999
limit	否	Integer	功能说明：每页返回的资源个数取值范围：1~2000 最小值：0 最大值：2000
fields	否	Array of strings	功能说明：查询字段，形式为“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/allow_share_bandwidth_types/public_border_group/alias/publicip_pool_name/publicip_pool_id 数组长度：0 - 999
sort_key	否	String	功能说明：排序字段，形式为“sort_key=id” 支持字段：id/public_ip_address/public_ipv6_address/ip_version/created_at/updated_at/public_border_group
sort_dir	否	String	功能说明：排序方向取值范围： asc 顺序 desc 倒序
id	否	Array of strings	功能说明：根据id过滤数组长度：0 - 999
ip_version	否	Array of integers	功能说明：根据ip_version过滤取值范围：4、6 数组长度：0 - 999
public_ip_address	否	Array of strings	功能说明：根据public_ip_address过滤数组长度：0 - 999
public_ip_address_like	否	String	功能说明：根据public_ip_address过滤，模糊搜索最小长度：0 最大长度：64
public_ipv6_address	否	Array of strings	功能说明：根据public_ipv6_address过滤数组长度：0 - 999
public_ipv6_address_like	否	String	功能说明：根据public_ipv6_address过滤，模糊搜索最小长度：0 最大长度：64
type	否	Array of strings	功能说明：根据type过滤取值范围： EIP：弹性公网IP DUALSTACK：双栈IPV6 数组长度：0 - 999
network_type	否	Array of strings	功能说明：根据network_type过滤取值范围：5_telcom、5_union、5_bgp、5_sbgp、5_ipv6、5_graybgp 数组长度：0 - 999
publicip_pool_name	否	Array of strings	功能说明：根据publicip_pool_name过滤取值范围：5_telcom、5_union、5_bgp、5_sbgp、5_ipv6、5_graybgp、专属池名称等数组长度：0 - 999
status	否	Array of strings	功能说明：根据status过滤取值范围：FREEZED、DOWN、ACTIVE、ERROR 数组长度：0 - 999
alias_like	否	String	功能说明：根据alias模糊搜索最小长度：0 最大长度：64
alias	否	Array of strings	功能说明：根据alias过滤数组长度：0 - 999
description	否	Array of strings	功能说明：根据description过滤数组长度：0 - 999
vnic.private_ip_address	否	Array of strings	功能说明：根据private_ip_address过滤数组长度：0 - 999
vnic.private_ip_address_like	否	String	功能说明：根据private_ip_address模糊搜索最小长度：0 最大长度：64
vnic.device_id	否	Array of strings	功能说明：端口所属设备ID，表示使用子网内私有IP地址的云服务资源ID，比如云服务器的ID、ELB的ID。可以根据根据device_id过滤数组长度：0 - 999
vnic.device_owner	否	Array of strings	功能说明：端口所属的设备，表示使用子网内私有IP地址的云服务资源。可以根据device_owner过滤数组长度：0 - 999
vnic.vpc_id	否	Array of strings	功能说明：根据vpc_id过滤数组长度：0 - 999
vnic.port_id	否	Array of strings	功能说明：根据port_id过滤数组长度：0 - 999
vnic.device_owner_prefixlike	否	String	功能说明：根据device_owner_prefixlike模糊搜索最小长度：0 最大长度：64
vnic.instance_type	否	Array of strings	功能说明：根据instance_type过滤数组长度：0 - 999
vnic.instance_id	否	Array of strings	功能说明：根据instance_id过滤数组长度：0 - 999
bandwidth.id	否	Array of strings	功能说明：根据id过滤数组长度：0 - 999
bandwidth.name	否	Array of strings	功能说明：根据name过滤数组长度：0 - 999
bandwidth.name_like	否	Array of strings	功能说明：根据name模糊过滤数组长度：0 - 999
bandwidth.size	否	Array of integers	功能说明：根据size过滤数组长度：0 - 999
bandwidth.share_type	否	Array of strings	功能说明：根据share_type过滤数组长度：0 - 999
bandwidth.charge_mode	否	Array of strings	功能说明：根据charge_mode过滤数组长度：0 - 999
billing_info	否	Array of strings	功能说明：根据billing_info过滤数组长度：0 - 999
billing_mode	否	String	功能说明：根据订单模式过滤, 取值范围： YEARLY_MONTHLY：包周期 PAY_PER_USE：按需
associate_instance_type	否	Array of strings	功能说明：公网IP绑定的实例类型，可以根据associate_instance_type字段过滤取值范围： PORT（云服务器实例类型，云服务器通常包括ECS、BMS、CCE等） NATGW（NAT网关实例类型） ELB（弹性负载均衡ELB实例类型） VPN（虚拟专用网络VPN实例类型）数组长度：0 - 999
associate_instance_id	否	Array of strings	功能说明：公网IP绑定的实例ID，可以根据associate_instance_id字段过滤数组长度：0 - 999
enterprise_project_id	否	Array of strings	功能说明：根据enterprise_project_id过滤数组长度：0 - 999
public_border_group	否	Array of strings	功能说明：根据public_border_group过滤数组长度：0 - 999
allow_share_bandwidth_type_any	否	Array of strings	功能说明：共享带宽类型，根据任一共享带宽类型过滤弹性公网IP列表。可以指定多个带宽类型，不同的带宽类型间用逗号分隔。数组长度：0 - 999

请求参数

无

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
request_id	String	本次请求的编号最小长度：0 最大长度：36
publicips	Array of PublicipSingleShowResp objects	弹性公网IP对象数组长度：0 - 9999
page_info	PageInfoOption object	分页页码信息
total_count	Integer	公网IP总条目数最小值：0 最大值：999999

表4 PublicipSingleShowResp
参数	参数类型	描述
id	String	功能说明：弹性公网IP唯一标识
project_id	String	功能说明：项目ID
ip_version	Integer	功能说明：IP版本信息取值范围： 4：公网IP地址为public_ip_address地址 6：公网IP地址为public_ipv6_address地址
public_ip_address	String	功能说明：弹性公网IP或者IPv6端口的地址约束：双栈（type=DUALSTACK）时会返回0.0.0.0，非正常EIPv4地址
public_ipv6_address	String	功能说明：IPv4时无此字段，IPv6时为申请到的弹性公网IP地址
network_type	String	功能说明：弹性公网IP的网络类型。废弃，功能由publicip_pool_name继承，默认不显示
status	String	功能说明：弹性公网IP的状态取值范围： FREEZED：冻结 BIND_ERROR：绑定失败 BINDING：绑定中 PENDING_DELETE：释放中 PENDING_CREATE：创建中 NOTIFYING：创建中 NOTIFY_DELETE：释放中 PENDING_UPDATE：更新中 DOWN：未绑定 ACTIVE：绑定 ELB：绑定ELB VPN：绑定VPN ERROR：失败
description	String	功能说明：弹性公网IP描述信息约束：用户以自定义方式标识资源，系统不感知
public_border_group	String	功能说明：表示中心站点资源或者边缘站点资源取值范围： center、边缘站点名称约束：publicip只能绑定该字段相同的资源
created_at	DateTime	功能说明：资源创建UTC时间格式：yyyy-MM-ddTHH:mm:ssZ
updated_at	DateTime	功能说明：资源更新UTC时间格式：yyyy-MM-ddTHH:mm:ssZ
type	String	功能说明：弹性公网IP类型
vnic	VnicInfo object	功能说明：公网IP绑定实例有PORT时，PORT的相关信息约束：如果绑定的实例不依赖PORT，该对象为null
bandwidth	PublicipBandwidthInfo object	功能说明：公网IP绑定带宽信息
enterprise_project_id	String	功能说明：企业项目ID。最大长度36字节,带“-”连字符的UUID格式，或者是字符串“0”。创建弹性公网IP时，给弹性公网IP绑定企业项目ID。
billing_info	String	功能说明：公网IP的订单信息约束：包周期才会有订单信息，按需资源此字段为空
lock_status	String	功能说明：记录公网IP当前的冻结状态约束：metadata类型，标识欠费冻结、公安冻结取值范围： police 公安冻结 locked 资源加锁
associate_instance_type	String	功能说明：公网IP绑定的实例类型取值范围： PORT（云服务器实例类型，云服务器通常包括ECS、BMS、CCE等） NATGW（NAT网关实例类型） ELB（弹性负载均衡ELB实例类型） VPN（虚拟专用网络VPN实例类型）
associate_instance_id	String	功能说明：公网IP绑定的实例ID
publicip_pool_id	String	功能说明：公网IP所属网络的ID，publicip_pool_name对应的网络ID
publicip_pool_name	String	功能说明：弹性公网IP的网络类型, 包括公共池类型，如5_bgp/5_sbgp...，和用户购买的专属池。专属池见publcip_pool相关接口
alias	String	功能说明：弹性公网IP名称
profile	ProfileInfo object	功能说明：公网IP、元数据。（默认不显示）
fake_network_type	Boolean	功能说明：该字段仅仅用于表示eip的bgp类型是否是真实的静态sbgp * 1，如果为true，则该eip可以切换bgp类型 * 2；如果为false，则该eip不可以切换bgp类型。（默认不显示）
tags	Array of strings	功能说明：用户标签。数组长度：0 - 9999
associate_instance_metadata	String	功能说明：记录实例的更上一层归属。例如associate_instance_type为PORT，此字段记录PORT的device_id和device_owner信息。仅有限场景记录。（默认不显示）
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地址
device_id	String	功能说明：端口所属设备ID，表示使用子网内私有IP地址的云服务资源ID，比如云服务器的ID、ELB的ID。约束：不支持设置和更新，由系统自动维护
device_owner	String	功能说明：端口所属的设备，表示使用子网内私有IP地址的云服务资源。取值范围：合法设备所属 network:dhcp（表示DHCP服务） network:VIP_PORT（表示创建的是虚拟IP） network:router_interface_distributed（表示子网网关地址） network:router_centralized_snat（表示SNAT网关地址）约束：不支持设置和更新，由系统自动维护
vpc_id	String	功能说明：虚拟私有云ID
port_id	String	功能说明：端口ID
port_profile	String	功能说明：端口profile信息
mac	String	功能说明：端口MAC地址约束：由系统分配，不支持指定
vtep	String	功能说明：VTEP IP
vni	String	功能说明：VXLAN ID
instance_id	String	功能说明：端口所属实例ID，例如RDS实例ID 约束：不支持设置和更新，由系统自动维护
instance_type	String	功能说明：端口所属实例类型，例如“RDS” 约束：不支持设置和更新，由系统自动维护
port_vif_details	String	功能说明：网卡虚拟接口的详细信息

表6 PublicipBandwidthInfo
参数	参数类型	描述
id	String	功能描述：带宽ID
size	Integer	功能描述：带宽大小取值范围：默认5Mbit/s~2000Mbit/s
share_type	String	功能说明：带宽类型，标识是否是共享带宽取值范围： PER：独享带宽 WHOLE：共享带宽约束：其中IPv6暂不支持WHOLE类型带宽。
charge_mode	String	功能说明：按流量计费还是按带宽计费取值范围： bandwidth：按带宽计费 traffic：按流量计费 95peak_plus：按增强型95计费
name	String	功能说明：带宽名称取值范围：1-64个字符，支持数字、字母、中文、_（下划线）、-（中划线）、.（点）
billing_info	String	功能说明：账单信息。如果billinginfo不为空，说明是包周期的带宽

表7 ProfileInfo
参数	参数类型	描述
local_network_port	String	功能说明：公网IP附属的5_xxx网络（如5_bgp）中的port_id
standalone	Boolean	功能说明：标识公网IP是否是和虚机一起创建的。true-独立创建；false-和虚机一起创建
notify_status	String	功能说明：云服务标识公网IP创建进度, 弹性公网IP服务内部使用
create_time	String	功能说明：公网IP创建时间
fake_network_type	Boolean	功能说明：该字段仅仅用于表示eip的bgp类型是否是真实的静态sbgp * 1，如果为true，则该eip可以切换bgp类型 * 2；如果为false，则该eip不可以切换bgp类型
create_source	String	功能说明：标识IP是和哪类资源一起购买的
ecs_id	String	功能说明：标识和公网IP一起购买的ecs的id
lock_status	String	功能说明：公网IP加锁状态, eg：“POLICE,LOCKED”。POLICE-公安冻结；LOCKED-普通冻结；普通冻结细分状态：ARREAR-欠费；DELABLE-可删除；
freezed_status	String	功能说明：公网IP冻结状态。
bandwith_info	BandwidthInfoResp object	功能说明：公网IP绑定的带宽信息

表8 BandwidthInfoResp
参数	参数类型	描述
bandwidth_name	String	功能说明：带宽名称
bandwidth_number	Integer	功能说明：带宽大小
bandwidth_type	String	功能说明：带宽类型
bandwidth_id	String	功能说明：带宽id

表9 PageInfoOption
参数	参数类型	描述
previous_marker	String	翻页时，作为前一页的marker取值最小长度：0 最大长度：36
next_marker	String	翻页时，作为后一页的marker取值最小长度：0 最大长度：36
current_count	Integer	当前页的数据总数最小值：0 最大值：99999

请求示例

查询全量弹性公网IP列表

GET https://{Endpoint}/v3/{project_id}/eip/publicips

响应示例

状态码：200

GET正常返回

{
  "page_info" : {
    "current_count" : 1,
    "next_marker" : "0490aeae-ab8f-4764-b012-45645e9c0aa9",
    "previous_marker" : "0490aeae-ab8f-4764-b012-45645e9c0aa9"
  },
  "publicips" : [ {
    "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" : "弹性公网IP",
    "vnic" : {
      "private_ip_address" : "172.16.1.235",
      "device_id" : "cdaba63f-d85d-4399-81c2-ee9764ad34dd",
      "device_owner" : "compute:regionB",
      "vpc_id" : "1c30f428-9741-48b2-a788-0b2f359705eb",
      "port_id" : "22d3576d-c042-4f3d-8c7c-1330a2724627",
      "mac" : "fa:16:3e:3a:22:66",
      "vtep" : "26.111.111.11",
      "vni" : 961184,
      "instance_id" : "",
      "instance_type" : "",
      "port_profile" : null,
      "port_vif_details" : "{\"primary_interface\": true}"
    },
    "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" : "c4962d006b34af3c2343de7f88ef65e3",
  "total_count" : 100
}

状态码


状态码	描述
200	GET正常返回

错误码

请参见错误码。

父主题：弹性公网IP

上一篇：弹性公网IP关闭NAT64

下一篇：查询弹性公网IP详情

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问