弹性公网IP EIP-查询弹性公网IP详情:响应参数

时间:2023-11-01 16:20:29

响应参数

状态码: 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

    • null

最小长度:0

最大长度:64

枚举值:

  • PORT

  • NATGW

  • ELB

  • ELBV1

  • VPN

  • null

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

  • 功能说明:用户标签。(默认不显示)

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

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

最大长度:256

bandwidth_number

Integer

  • 功能说明:带宽大小

最小值:0

最大值:99999

bandwidth_type

String

  • 功能说明:带宽类型

枚举值:

  • PER

  • WHOLE

bandwidth_id

String

  • 功能说明:带宽id

最小长度:0

最大长度:36

状态码: 400

表9 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 401

表10 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 403

表11 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 404

表12 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 405

表13 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 406

表14 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 407

表15 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 408

表16 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 409

表17 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 500

表18 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 501

表19 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 502

表20 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 503

表21 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

状态码: 504

表22 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

最小长度:0

最大长度:36

error_msg

String

服务异常错误信息描述

最小长度:0

最大长度:1024

error_code

String

服务异常错误信息编码

最小长度:0

最大长度:64

support.huaweicloud.com/api-eip/ShowPublicipV3.html