华为云计算 云知识 创建浮动IPNeutronCreateFloatingIp
创建浮动IPNeutronCreateFloatingIp

 

功能介绍

创建浮动IP的外部网络UUID,请使用GET /v2.0/networks?router:external=True或neutron net-external-list方式获取。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2.0/floatingips

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

floatingip

CreateFloatingIpOption2 object

创建floatingip对象

表2 CreateFloatingIpOption2

参数

是否必选

参数类型

描述

floating_ip_address

String

  • 功能说明:浮动IP地址。

最大长度:64

floating_network_id

String

  • 功能说明:外部网络的id

  • 约束:只能使用固定的外网,外部网络的信息请通过GET /v2.0/networks?router:external=True或GET /v2.0/networks?name={floating_network}或neutron net-external-list方式查询。

port_id

String

  • 功能说明:端口id

最大长度:36

fixed_ip_address

String

  • 功能说明:关联端口的私有IP地址。

最大长度:64

响应参数

状态码: 201

表3 响应Body参数

参数

参数类型

描述

floatingip

PostAndPutFloatingIpResp object

floatingip对象

表4 PostAndPutFloatingIpResp

参数

参数类型

描述

fixed_ip_address

String

  • 功能说明:关联端口的私有IP地址。

最小长度:0

最大长度:64

floating_ip_address

String

  • 功能说明:浮动IP地址。

最小长度:0

最大长度:64

floating_network_id

String

  • 功能说明:外部网络的id。

最小长度:0

最大长度:36

id

String

  • 功能说明:浮动IP地址的id。

最小长度:0

最大长度:36

port_id

String

  • 功能说明:端口id。

最小长度:0

最大长度:36

router_id

String

  • 功能说明:所属路由器id。

最小长度:0

最大长度:36

status

String

  • 功能说明:网络状态,可以为ACTIVE, DOWN或ERROR

  • 取值范围:

    • DOWN:未绑定

    • ACTIVE:绑定

    • ERROR:异常

枚举值:

  • ACTIVE

  • DOWN

  • ERROR

tenant_id

String

  • 功能说明:项目id。

最小长度:0

最大长度:36

dns_name

String

  • 功能说明:DNS名称,该参数当前仅在“华南-广州”开放

最小长度:0

最大长度:255

dns_domain

String

  • 功能说明:DNS域地址,该参数当前仅在“华南-广州”开放

最小长度:0

最大长度:255

请求示例

创建网络为0a2228f2-7f8a-45f1-8e09-9039e1d09975的浮动IP。

POST https://{Endpoint}/v2.0/floatingips

{
  "floatingip" : {
    "floating_network_id" : "0a2228f2-7f8a-45f1-8e09-9039e1d09975"
  }
}

响应示例

状态码: 201

POST操作正常返回

{
  "floatingip" : {
    "id" : "1a3a2818-d9b4-4a9c-8a19-5252c499d1cd",
    "status" : "DOWN",
    "router_id" : null,
    "tenant_id" : "bbfe8c41dd034a07bebd592bf03b4b0c",
    "floating_network_id" : "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
    "fixed_ip_address" : null,
    "floating_ip_address" : "88.88.215.205",
    "port_id" : null,
    "dns_name" : "ecs-88-99-103-61",
    "dns_domain" : "compute.hwclouds-dns.com."
  }
}

状态码

状态码

描述

201

POST操作正常返回

错误码

请参见错误码

 

上一篇:创建弹性伸缩策略CreateScalingPolicy 下一篇:为什么使用“垃圾”回收?