查询指定地域已创建的弹性 IP 接口功能介绍 调用此接口可查询指定地域已创建的弹性公网IP(Elastic IP Address,简称EIP)。 接口约束 无。 URI POST /v4/eip/list 请求参数 请求Body参数 参数 参数类型 是否必填 说明 示例 ::::: clientToken String 是 客户端存根,用于保证订单幂等性, 长度 1 64 79fa97e3c48bxxxx9f466a13d8163678 regionID String 是 资源池 ID projectID String 否 企业项目 ID,默认为"0" page Integer 否 分页参数 pageNo Integer 否 列表的页码,默认值为 1, 推荐使用该字段, page 后续会废弃 1 pageSize Integer 否 每页数据量大小,取值 050 ids Array of Strings 否 是 Array 类型,里面的内容是 String status string 否 eip状态 ACTIVE(已绑定)/ DOWN(未绑定)/ FREEZING(已冻结)/ EXPIRED(已过期),不传是查询所有状态的 EIP ipType string 否 ip类型 ipv4 / ipv6 eipType string 否 eip类型 normal / cn2 响应参数 参数 参数类型 说明 示例 :::: statusCode Integer 返回状态码(800为成功,900为失败) 800 message String statusCode为900时的错误信息; statusCode为800时为success, 英文 success description String statusCode为900时的错误信息; statusCode为800时为成功, 中文 成功 errorCode String statusCode为900时为业务细分错误码,三段式:product.module.code; statusCode为800时为SUCCESS SUCCESS returnObj Object object 返回结果 totalCount Integer 列表条目数 20 currentCount Integer 分页查询时每页的行数。 4 totalPage Integer 总页数 5 表 returnObj 参数 参数类型 说明 示例 :::: eips Array of Objects 弹性 IP 列表 见下表 表 eips 参数 参数类型 描述 说明 :::: ID String eip ID name String eip 名称 description String 描述 eipAddress String eip 地址 associationID String 当前绑定的实例的 ID associationType String 当前绑定的实例类型 privateIpAddress String 交换机网段内的一个 IP 地址 bandwidth Integer 带宽峰值大小,单位 Mb status String 1.ACTIVE 2.DOWN 3.ERROR 4.UPDATING 5.BANDINGORUNBANGDING 6.DELETING 7.DELETED 8.EXPIRED tags String EIP 的标签集合 createdAt String 创建时间 updatedAt String 更新时间 expiredAt String 到期时间 20221125T01:08:10Z