describeElasticIps
描述
查询弹性公网IP列表
支持分页查询,默认每页20条
请求方式
GET
请求地址
https://cps.jdcloud-api.com/v1/regions/{regionId}/elasticIps
名称 |
类型 |
是否必需 |
默认值 |
描述 |
regionId |
String |
True |
|
地域ID,可调用接口(describeRegiones)获取云物理服务器支持的地域 |
请求参数
名称 |
类型 |
是否必需 |
默认值 |
描述 |
pageNumber |
Integer |
False |
1 |
页码;默认为1 |
pageSize |
Integer |
False |
20 |
分页大小;默认为20;取值范围[20, 100] |
status |
String |
False |
|
弹性公网IP状态,取值范围:associate、disassociate |
includeLB |
String |
False |
|
是否包含负载均衡 |
chargeMode |
String |
False |
|
支付模式,取值为:prepaid_by_duration表示预付费,postpaid_by_duration表示按配置后付费 |
instanceId |
String |
False |
|
实例Id |
subnetId |
String |
False |
|
子网Id |
filters |
Filter[ ] |
False |
|
elasticIpId - 弹性公网IPID,精确匹配,支持多个
elasticIp - 弹性公网IP,精确匹配,支持多个
|
Filter
名称 |
类型 |
是否必需 |
默认值 |
描述 |
name |
String |
True |
|
过滤条件的名称 |
operator |
String |
False |
|
过滤条件的操作符,默认eq |
values |
String[ ] |
True |
|
过滤条件的值 |
返回参数
名称 |
类型 |
描述 |
result |
Result |
|
requestId |
String |
|
Result
名称 |
类型 |
描述 |
elasticIps |
ElasticIp[ ] |
|
pageNumber |
Integer |
页码;默认为1 |
pageSize |
Integer |
分页大小;默认为20;取值范围[20, 100] |
totalCount |
Integer |
查询结果总数 |
ElasticIp
名称 |
类型 |
描述 |
region |
String |
地域代码, 如cn-north-1 |
elasticIpId |
String |
弹性公网IPID |
elasticIp |
String |
弹性公网IP |
bandwidth |
Integer |
带宽, 单位Mbps |
lineType |
String |
链路类型 |
status |
String |
状态 |
instanceType |
String |
实例类型 |
instanceId |
String |
实例ID |
targetIp |
String |
绑定的ip地址 |
createTime |
String |
创建时间 |
charge |
Charge |
计费信息 |
Charge
名称 |
类型 |
描述 |
chargeMode |
String |
支付模式,取值为:prepaid_by_duration,postpaid_by_usage或postpaid_by_duration,prepaid_by_duration表示预付费,postpaid_by_usage表示按用量后付费,postpaid_by_duration表示按配置后付费,默认为postpaid_by_duration |
chargeStatus |
String |
费用支付状态,取值为:normal、overdue、arrear,normal表示正常,overdue表示已到期,arrear表示欠费 |
chargeStartTime |
String |
计费开始时间,遵循ISO8601标准,使用UTC时间,格式为:YYYY-MM-DDTHH:mm:ssZ |
chargeExpiredTime |
String |
过期时间,预付费资源的到期时间,遵循ISO8601标准,使用UTC时间,格式为:YYYY-MM-DDTHH:mm:ssZ,后付费资源此字段内容为空 |
chargeRetireTime |
String |
预期释放时间,资源的预期释放时间,预付费/后付费资源均有此值,遵循ISO8601标准,使用UTC时间,格式为:YYYY-MM-DDTHH:mm:ssZ |
返回码
返回码 |
描述 |
200 |
OK |
400 |
Bad request |
404 |
Not found |
500 |
Internal server error |
503 |
Service unavailable |