DescribeEipAddresses

EipAddresses.N

String

否

EipAddresses.1=12.XX.XX.89&EipAddresses.2=12.XX.XX.35

公网IP地址。

• 参数 - N：表示公网IP的IP地址的序号，单次调用数量上限100个IP地址。
• 多个公网IP的IP地址之间用&分隔。

AllocationIds.N

String

否

AllocationIds.1=eip-2zeewb7ujxscd****&AllocationIds.2=eip-2wrfgeb3efghxs****

要查询的公网IP的ID。

• 参数 - N：表示公网IP ID的序号，单次调用数量上限100个ID。
• 多个ID之间请使用&分隔。

ISP

String

否

BGP

线路类型。取值如下：

• BGP：BGP（多线）。
• 若您的账号已申请并开通了静态单线权限，则可传入如下取值：
  • ChinaMobile：中国移动静态单线。
  • ChinaTelecom：中国电信静态单线。
  • ChinaUnicom：中国联通静态单线。
• 若您的账号已申请并开通了BGP单线权限，则可传入SingleLine_BGP。
• 若您的账号已申请并开通了融合BGP权限，则可传入Fusion_BGP。
• 若您的账号已申请并开通了惠选型静态单线权限，则可传入如下取值：
  • ChinaMobile_Value：中国移动惠选型静态单线。
  • ChinaUnicom_Value：中国联通惠选型静态单线。
  • ChinaTelecom_Value：中国电信惠选型静态单线。

BillingType

Integer

否

2

公网IP的计费方式。取值如下：

• 1：包年包月。
• 2：按量计费-按带宽上限计费。
• 3：按量计费-按实际流量计费。

SecurityProtectionEnabled

Boolean

否

true

安全防护。取值如下：

• true：增强防护类型的公网IP（可加入到DDoS原生防护（企业版）实例）。
• false：默认防护类型的公网IP。

TagFilters.N.Key

String

否

TagFilters.1.Key=k1&TagFilters.2.Key=k2&TagFilters.3.Key=k3

标签的标签键。

• 参数 - N：表示标签键的序号，取值范围：1～10。
• 多个标签键之间用&分隔。多个标签键之间的关系为逻辑“与（AND）”，即查询同时添加多个标签键的公网IP。
• 不允许重复。

TagFilters.N.Values.N

String

否

TagFilters.1.Values.1=v1&TagFilters.1.Values.2=v2&TagFilters.3.Values.1=v1

标签的标签值。

• 第一个N：表示标签键的序号，取值范围：1～10。
• 第二个N：表示标签值的序号，取值范围：1～3。同一标签键多个标签值之间的关系为逻辑“或(OR)”，即查询同一标签键下添加其中一个标签值的公网IP。
• 多个标签值之间用&分隔。

AssociatedInstanceType

String

否

EcsInstance

当前绑定云产品的类型。取值如下：

• Nat：公网NAT网关。
• NetworkInterface： 辅助网卡。
• ClbInstance：负载均衡。
• Albinstance：应用型负载均衡。
• EcsInstance：云服务器。
• HaVip：高可用虚拟IP。

Status

String

否

Available

公网IP的状态。取值如下：

• Attaching：绑定中。
• Detaching：解绑中。
• Attached：已绑定。
• Available：可用。
• Deleting：删除中。

PageNumber

Integer

否

1

列表的页码。默认值为1。

PageSize

Integer

否

20

分页查询时每页的行数。最大值为100，默认值为20。

NextToken

String

否

caeba0bbb2be03f84eb48b699f0a****

分页查询凭证，用于标记分页的位置。

• 不填则从头开始查询。
• 传入之前调用本API返回的NextToken，则从该次API调用标记分页的位置往后开始查询。

TotalCount

Integer

2

符合条件的公网IP总数。

PageNumber

Integer

1

当前页码。

PageSize

Integer

10

当前分页的行数。

SecurityProtectionTypes

List

["AntiDDoS_Enhanced"]

安全防护类型。

• AntiDDoS_Enhanced：增强防护类型的公网IP（可加入到DDoS原生防护（企业版）实例）。
• 空值： 默认防护类型的公网IP。

IsBlocked

Boolean

true

是否被封禁。

• true：是。
• false：否。

ReleaseWithInstance

Boolean

true

是否随云服务器实例删除。仅按量计费公网IP有效。开启后，当云服务器实例被系统自动回收（退订24小时后、到期回收、欠费回收）或被调用DeleteInstances接口时，公网IP随其一同释放。

• true：是。
• false：否。

BusinessStatus

String

FinancialLocked

公网IP是否被锁定。

• Normal: 正常。
• FinancialLocked: 被锁定。

LockReason

String

financial

公网IP被锁定的原因。

• financial： 因欠费被锁定。
• unlock：欠费关停后充值恢复过程中。
• 空值：没有被锁定。

ExpiredTime

String

2021-05-07 23:59:59

公网IP的到期时间。

• 包年包月，返回值为到期时间。
• 按量计费，返回值为空。

DeletedTime

String

2021-04-30 01:00:00

预期资源强制回收时间。

• 包年包月公网IP，此参数有返回值。
• 按量计费公网IP，仅欠费冻结时，此参数有返回值。