更新时间:2023-12-25 GMT+08:00

查询浮动IP

功能介绍

该接口用于查询指定浮动IP详情,包括浮动IP状态,浮动IP所属路由器ID,浮动IP的外部网络ID等等。

URI

GET /v2.0/floatingips/{floatingip_id}

请求消息

响应消息

表1 响应参数

参数名称

类型

说明

floatingip

floatingip object

floatingip对象列表,参见表2

表2 floatingip对象

属性

类型

说明

status

String

网络状态,可以为ACTIVE, DOWN或ERROR。

  • DOWN:未绑定
  • ACTIVE:绑定
  • ERROR:异常

id

String

浮动IP地址的id。

project_id

String

项目ID

floating_ip_address

String

浮动IP地址。

floating_network_id

String

外部网络的id。

router_id

String

所属路由器id。

port_id

String

端口id

fixed_ip_address

String

关联端口的私有IP地址。

tenant_id

String

项目ID

dns_name

String

DNS名称

该参数当前仅在“华南-广州”开放

dns_domain

String

DNS域地址

该参数当前仅在“华南-广州”开放

created_at

String

资源创建时间

采用UTC时间

格式:YYYY-MM-DDTHH:MM:SS

updated_at

String

资源更新时间

采用UTC时间

格式:YYYY-MM-DDTHH:MM:SS

请求示例

GET https://{Endpoint}/v2.0/floatingips/1a3a2818-d9b4-4a9c-8a19-5252c499d1cd

响应示例

状态码: 200

{
    "floatingip": {
        "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,
        "created_at": "2017-10-19T12:21:28",
        "updated_at": "2018-07-30T12:52:13"
    }
}

状态码

请参见状态码

错误码

请参见错误码