功能介绍
查询提交请求的租户有权限操作的所有浮动IP地址。单次查询最多返回2000条数据,超过2000后会返回分页标记。
接口约束
单次查询最多返回2000条数据,超过2000后会返回分页标记。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2.0/floatingips
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
最小值:0 最大值:2000 |
marker |
否 |
String |
最小长度:0 最大长度:36 |
page_reverse |
否 |
Boolean |
|
id |
否 |
String |
最小长度:0 最大长度:36 |
floating_ip_address |
否 |
String |
最小长度:0 最大长度:64 |
router_id |
否 |
String |
最小长度:0 最大长度:36 |
port_id |
否 |
String |
最小长度:0 最大长度:36 |
fixed_ip_address |
否 |
String |
最小长度:0 最大长度:64 |
tenant_id |
否 |
String |
最小长度:0 最大长度:36 |
floating_network_id |
否 |
String |
最小长度:0 最大长度:36 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
floatingips |
floatingip对象列表 数组长度:0 - 99999 |
|
floatingips_links |
floatingips_link对象列表 数组长度:0 - 99999 |
参数 |
参数类型 |
描述 |
---|---|---|
fixed_ip_address |
String |
最小长度:0 最大长度:64 |
floating_ip_address |
String |
最小长度:0 最大长度:64 |
floating_network_id |
String |
最小长度:0 最大长度:36 |
id |
String |
最小长度:0 最大长度:36 |
port_id |
String |
最小长度:0 最大长度:36 |
router_id |
String |
最小长度:0 最大长度:36 |
status |
String |
枚举值:
|
tenant_id |
String |
最小长度:0 最大长度:36 |
project_id |
String |
最小长度:0 最大长度:36 |
dns_name |
String |
最小长度:0 最大长度:255 |
dns_domain |
String |
最小长度:0 最大长度:255 |
created_at |
String |
|
updated_at |
String |
|
请求示例
-
GET https://{Endpoint}/v2.0/floatingips?limit=1
-
GET https://{Endpoint}/v2.0/floatingips?id={fip_id}&router_id={router_id}&floating_network_id={net_id}&
floating_ip_address={floating_ip}&port_id={port_id}&fixed_ip_address={fixed_ip}&project_id={project_id}
响应示例
状态码: 200
GET操作正常返回
{ "floatingips" : [ { "id" : "1a3a2818-d9b4-4a9c-8a19-5252c499d1cd", "status" : "DOWN", "router_id" : null, "tenant_id" : "bbfe8c41dd034a07bebd592bf03b4b0c", "project_id" : "bbfe8c41dd034a07bebd592bf03b4b0c", "floating_network_id" : "0a2228f2-7f8a-45f1-8e09-9039e1d09975", "fixed_ip_address" : null, "floating_ip_address" : "99.99.99.84", "port_id" : null, "dns_name" : "ecs-88-99-103-61", "dns_domain" : "compute.hwclouds-dns.com.", "created_at" : "2017-10-19T12:21:28", "updated_at" : "2018-07-30T12:52:13" } ], "floatingips_links" : [ { "href" : "https://network.region.cn-southwest-2.hwclouds.com/v2.0/floatingips.json?
limit=2000&marker=000a6144-5010-46f2-bf06-6a1c94477ea3&page_reverse=true", "rel" : "previous" }, { "href" : "https://network.region.cn-southwest-2.hwclouds.com/v2.0/floatingips.json?
limit=2000&marker=d445e537-bc81-4039-9c7b-f9c1f5c73c78", "rel" : "next" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
GET操作正常返回 |
错误码
请参见错误码。