查询弹性公网IP详情 - ShowPublicip

project_id

是

String

参数解释：

项目ID 参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

publicip_id

是

String

参数解释：

弹性公网IP的ID。

约束限制：

不涉及。

取值范围：

最大长度36。

默认取值：

不涉及。

最大长度：36

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/publicip_pool_name/allow_share_bandwidth_types/alias/publicip_pool_id/public_border_group

取值范围：

数组长度0-999

默认取值：

不涉及。

request_id

String

参数解释：

本次请求的编号。

取值范围：

不涉及。

publicip

PublicipSingleShowResp object

参数解释：

弹性公网IP对象。

取值范围：

不涉及。

id

String

参数解释：

弹性公网IP唯一标识。

取值范围：

不涉及。

project_id

String

参数解释：

项目ID。

取值范围：

不涉及。

ip_version

Integer

参数解释：

IP版本信息。

取值范围：

4：IPv4地址。

6：IPv6地址。

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、边缘站点名称。

created_at

String

参数解释：

资源创建UTC时间。

取值范围：

格式：yyyy-MM-ddTHH:mm:ssZ

updated_at

String

参数解释：

资源更新UTC时间。

取值范围：

格式：yyyy-MM-ddTHH:mm:ssZ

type

String

参数解释：

弹性公网IP类型。

取值范围：

• EIP：IPV4类型的弹性公网IP。

• DUALSTACK：IPV6类型的弹性公网IP。

vnic

VnicInfo object

参数解释：

公网IP绑定实例有PORT时，PORT的相关信息。如果绑定的实例不依赖PORT，该对象为null。

取值范围：

不涉及。

bandwidth

PublicipBandwidthInfo object

参数解释：

公网IP绑定带宽信息。

取值范围：

不涉及。

enterprise_project_id

String

参数解释：

企业项目ID。创建弹性公网IP时，给弹性公网IP绑定企业项目ID。

取值范围：

最大长度36字节,带“-”连字符的UUID格式，或者是字符串“0”。

billing_info

String

参数解释：

公网IP的订单信息。

取值范围：

包周期才会有订单信息，按需资源此字段为空。

lock_status

String

参数解释：

记录公网IP当前的冻结状态。metadata类型，标识欠费冻结、公安冻结。

取值范围：

• police 公安冻结。

• locked 资源加锁。

associate_instance_type

String

参数解释：

公网IP绑定的实例类型，可以根据associate_instance_type字段过滤。

取值范围：

• PORT（云服务器实例类型，云服务器通常包括ECS、BMS、CCE等）

• NATGW（NAT网关实例类型）

• ELB（弹性负载均衡ELB实例类型）

• ELBV1（弹性负载均衡ELBV1实例类型，存量经典型ELBv1）

• 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...，和用户购买的专属池。专属池见publicip_pool相关接口。

取值范围：

不涉及。

alias

String

参数解释：

弹性公网IP名称。

取值范围：

不涉及。

profile

ProfileInfo object

参数解释：

公网IP、元数据。（默认不显示）

取值范围：

不涉及。

fake_network_type

Boolean

参数解释：

该字段仅仅用于表示eip的bgp类型是否是真实的静态sbgp。

取值范围：

• TRUE：该eip可以切换bgp类型。

• FALSE：该eip不可以切换bgp类型。（默认不显示）

tags

Array of strings

参数解释：

用户标签。

取值范围：

不涉及。

associate_instance_metadata

String

参数解释：

记录实例的更上一层归属。例如associate_instance_type为PORT，此字段记录PORT的device_id和device_owner信息。仅有限场景记录。（默认不显示）

取值范围：

数组长度0-9999

associate_mode

String

参数解释：

开启支持直通模式后展示，表示直通模式的标识。（默认不显示）

取值范围：

不涉及。

allow_share_bandwidth_types

Array of strings

参数解释：

表示此publicip可以加入的共享带宽类型列表，如果为空列表，则表示该publicip不能加入任何共享带宽。publicip只能加入到有该带宽类型的共享带宽中

取值范围：

数组长度0-9999

cascade_delete_by_instance

Boolean

参数解释：

表示该eip是否支持与实例同步删除。（默认不显示）

取值范围：

不涉及。

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

参数解释：

port的使用者。

取值范围：

• PORT：弹性网卡。

• PEP_PORT：PEP弹性网卡。

• EVPN：以太网虚拟私有网络。

• NATGW：NAT网关。

• P2CVPN：P2C虚拟专用网络。

port_vif_details

String

参数解释：

网卡虚拟接口的详细信息。

取值范围：

不涉及。

id

String

参数解释：

带宽ID。

取值范围：

不涉及。

size

Integer

参数解释：

带宽大小。

取值范围：

默认5Mbit/s~2000Mbit/s。

share_type

String

参数解释：

带宽类型，标识是否是共享带宽。其中IPv6暂不支持WHOLE类型带宽。

取值范围：

• PER：独享带宽

• WHOLE：共享带宽

charge_mode

String

参数解释：

按流量计费还是按带宽计费。

取值范围：

• bandwidth：按带宽计费

• traffic：按流量计费

• 95peak_plus：按增强型95计费

name

String

参数解释：

带宽名称。

取值范围：

1-64个字符，支持数字、字母、中文、_（下划线）、-（中划线）、.（点）。

billing_info

String

参数解释：

账单信息。如果billinginfo不为空，说明是包周期的带宽。

取值范围：

不涉及。

local_network_port

String

参数解释：

公网IP附属的5_xxx网络（如5_bgp）中的port_id。

取值范围：

不涉及。

standalone

Boolean

参数解释：

标识公网IP是否是和虚机一起创建的。

取值范围：

• true：独立创建

• false：和虚机一起创建

notify_status

String

参数解释：

云服务标识公网IP创建进度, 弹性公网IP服务内部使用。

取值范围：

• PENDING_CREATE

• PENDING_UPDATE

• NOTIFYING

• NOTIFYED

• NOTIFY_DELETE

create_time

String

参数解释：

公网IP创建时间。

取值范围：

不涉及。

fake_network_type

Boolean

参数解释：

该字段仅仅用于表示eip的bgp类型是否是真实的静态sbgp。

取值范围：

• TRUE：该eip可以切换bgp类型。

• FALSE：该eip不可以切换bgp类型。（默认不显示）。

create_source

String

参数解释：

标识IP是和哪类资源一起购买的。

取值范围：

不涉及。

ecs_id

String

参数解释：

标识和公网IP一起购买的ecs的id。

取值范围：

不涉及。

lock_status

String

参数解释：

公网IP加锁状态。

取值范围：

POLICE:公安冻结

LOCKED:普通冻结

• 普通冻结细分状态：ARREAR-欠费冻结；DELABLE-可删除冻结；

freezed_status

String

参数解释：

公网IP冻结状态。

取值范围：

• FREEZED：冻结状态。

• UNFREEZED：未冻结状态。

bandwidth_info

BandwidthInfoResp object

参数解释：

公网IP绑定的带宽信息。

取值范围：

不涉及。

bandwidth_name

String

参数解释：

带宽名称。

取值范围：

不涉及。

bandwidth_number

Integer

参数解释：

带宽大小。

取值范围：

不涉及。

bandwidth_type

String

参数解释：

根据带宽类型过滤。

取值范围：

• PER：独享带宽。

• WHOLE: 共享带宽。

bandwidth_id

String

参数解释：

带宽id。

取值范围：

格式：[A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12}

200

GET操作正常返回