查询弹性公网IP列表
1. 接口描述
调用 DescribeEips 接口查询指定地域已创建的弹性公网IP。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：DescribeEips |
| RegionCode | String | 是 | 弹性公网IP所属的地域编码，您可以调用 DescribeRegionConfig 接口获取地域编码 |
| InstanceUUID | String | 否 | 实例ID |
| PageNumber | integer | 否 | 弹性公网IP列表的页， 起始值：1 默认值：1 |
| PageSize | integer | 否 | 分页查询时设置的每页行数， 最大值：50 默认值：10 |
2. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| Items | Array[ EipInfo ] | 弹性公网IP信息列表 |
| RequestId | String | 请求ID |
| Total | Integer | 弹性公网IP总数 |
4. 示例
请求示例
https://openapi.kaopuyun.com/?AccessKeyId=sz0000ei53aw
&Action=DescribeEips
&Format=JSON
&RegionCode=cn-fuzhou-5
&SignatureMethod=HMAC-SHA1
&SignatureNonce=76a5d5e7-0992-462d-9a26-916650eca00f
&SignatureVersion=1.0
&Timestamp=2023-03-09T07%3A33%3A56Z
&Version=2014-05-26
&Signature=LH5UYKO7k%2FeQlyLH3p169uyRKyU%3D
&PageNumber=1
&PageSize=10
正常返回示例
{
"RequestId": "65282870-d091-11ee-bbdc-d2b94c0cf929",
"Total": 3,
"Items": [
{
"EipPendingStatus": "NONE",
"InstanceUUID": "ecs-lf0000014b9j",
"RegionCode": "cn-fuzhou-5",
"InstanceChargeType": "PRE_PAID",
"EipStatus": "AVAILABLE",
"AutoRenew": "INFINITE",
"IpBindLevel": "MAIN",
"EipUUID": "eip-lf0000014b9k",
"ExpirationTime": "2024-02-29 23:59:59",
"EipSeries": "Normal",
"InternetChargeType": "PAY_BY_BAND_WIDTH",
"AllocationTime": "2024-02-04 13:56:56",
"BandwidthType": "CMCC",
"FlowPacketUUIDs": [],
"Bandwidth": 1,
"EipAddress": "69.62.44.74",
"BandwidthLimit": false
},
{
"EipPendingStatus": "NONE",
"RegionCode": "cn-fuzhou-5",
"InstanceChargeType": "PRE_PAID",
"EipStatus": "AVAILABLE",
"AutoRenew": "INFINITE",
"EipUUID": "eip-gf0000010se6",
"ExpirationTime": "2024-02-29 23:59:59",
"EipSeries": "Normal",
"InternetChargeType": "PAY_BY_BAND_WIDTH",
"AllocationTime": "2024-01-29 14:00:17",
"BandwidthType": "CMCC",
"FlowPacketUUIDs": [],
"Bandwidth": 1,
"EipAddress": "69.62.44.67",
"BandwidthLimit": false
}
]
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | RegionCode 参数不能为空 |
| AvailableRegionNotFound | 可用的地域未找到 |
| InvalidPageNumber | 分页数错误 |
| InvalidPageSize | 每页数量错误 |
| DescribeEipsFail | 查询弹性公网IP列表失败:xxx |