全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
专有网络 VPC

查询弹性公网IP列表

更新时间:2017-11-06 17:11:58

描述

查询指定地域的EIP列表。此接口支持分页查询,每页的数量默认为10条。

  • 此接口不会校验参数之间的依赖关系,返回结果是所有条件的“交集”。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:DescribeEipAddresses
RegionId String 需要查询的地域
Status String Eip状态,包括Associating | Unassociating | InUse | Available
EipAddress String EIP
AllocationId String 申请Id
AssociatedInstanceType String 绑定的资源的类型;
这是一个过滤器性质的参数,若不指定,则表示不使用该条件对结果进行过滤。
取值范围:EcsInstance | SlbInstance | Nat | HaVip 。
注意:区分大小写
AssociatedInstanceId String 绑定的资源的Id。
这是一个过滤器性质的参数,若不指定,则表示不适用该条件对结果进行过滤。
如果要使用该过滤器,必须同时使用AssociatedInstanceType。
若InstanceType为EcsInstance,则此处填写ECS实例Id。
若InstanceType为SlbInstance,则此处填写VPC类型的私网SLB 的实例ID。
若InstanceType为Nat,则此处填写NAT 的实例ID。。
若InstanceType为HaVip,则此处填写HaVipId。
PageNumber Integer 实例状态列表的页码,起始值为1,默认值为1
PageSize Integer 分页查询时设置的每页行数,最大值50行,默认为10

返回参数

名称 类型 描述
EipAddresses EipAddressSetType 弹性IP地址详情EipAddressSetType组成的集合
TotalCount Integer 列表条条目数
PageNumber Integer 当前页码
PageSize Integer 当前分页包含多少条目

错误码

错误代码 描述 Http 状态码 语义
Forbidden.RegionNotFound Specified region is not found during access authentication. 404 指定的region不存在
InvalidIAssociatedInstanceType.ValueNotSupported The specified value of AssociatedInstanceType is not supported. 400 AssociatedInstanceType的输入值不合法。

示例

请求示例

  1. https://vpc.aliyuncs.com/?Action=DescribeEipAddresses
  2. &RegionId=cn-hangzhou-1
  3. &<公共请求参数>

返回示例

XML格式

  1. <describeeipaddressesResponse>
  2. <PageNumber>1</PageNumber>
  3. <EipAddresses>
  4. <EipAddress>
  5. <ChargeType>PostPaid</ChargeType>
  6. <InstanceId>lb-2ze7a4u99pwm51pmlh76b</InstanceId>
  7. <AllocationTime>2017-11-02T13:03:30Z</AllocationTime>
  8. <Descritpion/>
  9. <IpAddress>39.106.22.136</IpAddress>
  10. <AllocationId>eip-2zefb1s5hys25jt916sgj</AllocationId>
  11. <InternetChargeType>PayByTraffic</InternetChargeType>
  12. <InstanceType>SlbInstance</InstanceType>
  13. <Name/>
  14. <Status>InUse</Status>
  15. <BandwidthPackageId>cbwp-2ze2ic1xd2qeqk145pn4u</BandwidthPackageId>
  16. <RegionId>cn-beijing</RegionId>
  17. <OperationLocks/>
  18. <ExpiredTime/>
  19. <Bandwidth>5</Bandwidth>
  20. </EipAddress>
  21. <EipAddress>
  22. <ChargeType>PostPaid</ChargeType>
  23. <InstanceId>ngw-2zegl86kv6x0p7qy5n6jp</InstanceId>
  24. <AllocationTime>2017-11-02T00:37:38Z</AllocationTime>
  25. <Descritpion/>
  26. <IpAddress>39.106.26.126</IpAddress>
  27. <AllocationId>eip-2ze80pr591z7rzw26t35l</AllocationId>
  28. <InternetChargeType>PayByTraffic</InternetChargeType>
  29. <InstanceType>Nat</InstanceType>
  30. <Name/>
  31. <Status>InUse</Status>
  32. <BandwidthPackageId/>
  33. <RegionId>cn-beijing</RegionId>
  34. <OperationLocks/>
  35. <ExpiredTime/>
  36. <Bandwidth>5</Bandwidth>
  37. </EipAddress>
  38. <EipAddress>
  39. <ChargeType>PostPaid</ChargeType>
  40. <AllocationTime>2017-10-26T08:40:28Z</AllocationTime>
  41. <InstanceId/>
  42. <Descritpion/>
  43. <IpAddress>39.106.13.253</IpAddress>
  44. <AllocationId>eip-2zet3wxfhwwsn57jmq8jb</AllocationId>
  45. <InternetChargeType>PayByTraffic</InternetChargeType>
  46. <InstanceType/>
  47. <Name/>
  48. <Status>Available</Status>
  49. <BandwidthPackageId/>
  50. <RegionId>cn-beijing</RegionId>
  51. <OperationLocks/>
  52. <ExpiredTime/>
  53. <Bandwidth>5</Bandwidth>
  54. </EipAddress>

JSON格式

本文导读目录