列举floatingip
功能介绍
列举公网ip。
URI
GET /v2.0/routers
请求消息
| 参数 | 是否可选 | 参数类型 | 描述 |
|---|---|---|---|
| all_tenant | 是 | bool | 获取所有的flatingip |
请求示例
GET /v2.0/floatingips?all=True
响应消息
| 参数 | 参数类型 | 描述 |
|---|---|---|
| floatingips | array | flatingip对象列表 |
| id | String | floatingip id |
| router_id | String | floatingip如果绑定给路由，路由的id |
| status | String | 状态 |
| tenant_id | String | 租户id |
| project_id | String | 租户id |
| created_at | String | 创建时间 |
| updated_at | String | 上次更新时间 |
| revision_number | integer | The revision number of the resource. |
| description | String | 描述 |
| dns_domain | String | DNS域 |
| dns_name | String | DNS名 |
响应示例
{
"floatingips":[
{
"router_id":null,
"status":"DOWN",
"description":"",
"tenant_id":"cf8d21b7fc084813a0481fb9bf331357",
"created_at":"2021-02-25T06:13:07Z",
"updated_at":"2021-02-25T06:13:07Z",
"floating_network_id":"096c7e01-28ab-46e5-9427-1444f6f67a12",
"fixed_ip_address":null,
"floating_ip_address":"172.16.10.131",
"revision_number":2,
"project_id":"cf8d21b7fc084813a0481fb9bf331357",
"port_id":null,
"id":"145c964a-1951-4a34-b62f-441e0d3e2675",
"qos_policy_id":"c15ce4a2-787e-4225-82f7-5ba538f0715e"
},
{
"router_id":null,
"status":"DOWN",
"description":"",
"tenant_id":"2caf92e24f284a76be9cb54577ecebed",
"created_at":"2021-02-25T06:04:45Z",
"updated_at":"2021-02-25T06:04:45Z",
"floating_network_id":"096c7e01-28ab-46e5-9427-1444f6f67a12",
"fixed_ip_address":null,
"floating_ip_address":"172.16.10.130",
"revision_number":2,
"project_id":"2caf92e24f284a76be9cb54577ecebed",
"port_id":null,
"id":"63f0999f-b020-42f8-a7cb-13437124a611",
"qos_policy_id":"c15ce4a2-787e-4225-82f7-5ba538f0715e"
}
]
}创建floatingip
功能介绍
创建公网ip。
URI
POST /v2.0/floatingips
请求消息
| 参数 | 是否可选 | 参数类型 | 描述 |
|---|---|---|---|
| floatingip | 否 | object | floatingip对象 |
| floatingip:floating_network_id | 否 | String | floatingip所属网络 |
| floatingip:floating_ip_address | 是 | String | floatingip的IP address |
| floatingip:qos_policy_id | 是 | String | 给floatingip添加Qos规则 |
请求示例
POST /v2.0/floatingips
{
"floatingip":{
"floating_network_id":"096c7e01-28ab-46e5-9427-1444f6f67a12",
"floating_ip_address":"172.16.10.131",
"qos_policy_id":"c15ce4a2-787e-4225-82f7-5ba538f0715e"
}
}响应示例
{
"floatingip":{
"router_id":null,
"status":"DOWN",
"description":"",
"tenant_id":"cf8d21b7fc084813a0481fb9bf331357",
"extra_fields":{
"bandwidth":1024
},
"updated_at":"2021-02-25T06:13:07Z",
"floating_network_id":"096c7e01-28ab-46e5-9427-1444f6f67a12",
"fixed_ip_address":null,
"floating_ip_address":"172.16.10.131",
"revision_number":2,
"created_at":"2021-02-25T06:13:07Z",
"project_id":"cf8d21b7fc084813a0481fb9bf331357",
"port_id":null,
"id":"145c964a-1951-4a34-b62f-441e0d3e2675",
"qos_policy_id":"c15ce4a2-787e-4225-82f7-5ba538f0715e"
}
}显示floatingip详情
功能介绍
现实公网ip详情。
URI
GET /v2.0/floatingips/[floatingip id]
请求消息
| 参数 | 是否可选 | 参数类型 | 描述 |
|---|---|---|---|
| floatingip_id | 否 | String | floating ip uuid |
请求示例
GET /v2.0/floatingips/145c964a-1951-4a34-b62f-441e0d3e2675
响应示例
{
"floatingip":{
"router_id":null,
"status":"DOWN",
"description":"",
"tenant_id":"cf8d21b7fc084813a0481fb9bf331357",
"extra_fields":{
"bandwidth":1024
},
"updated_at":"2021-02-25T06:13:07Z",
"floating_network_id":"096c7e01-28ab-46e5-9427-1444f6f67a12",
"fixed_ip_address":null,
"floating_ip_address":"172.16.10.131",
"revision_number":2,
"created_at":"2021-02-25T06:13:07Z",
"project_id":"cf8d21b7fc084813a0481fb9bf331357",
"port_id":null,
"id":"145c964a-1951-4a34-b62f-441e0d3e2675",
"qos_policy_id":"c15ce4a2-787e-4225-82f7-5ba538f0715e"
}
}更新floatingip
功能介绍
更新公网ip。
URI
PUT /v2.0/floatingips/[floatingip id]
请求消息
| 参数 | 是否可选 | 参数类型 | 描述 |
|---|---|---|---|
| floatingip | 否 | object | floatingip对象 |
| floatingip:floating_network_id | 否 | String | floatingip所属网络 |
| floatingip:floating_ip_address | 是 | String | floatingip的IP address |
| floatingip:qos_policy_id | 是 | String | 给floatingip添加Qos规则 |
请求示例
PUT /v2.0/floatingips/145c964a-1951-4a34-b62f-441e0d3e2675
{
"floatingip":{
"qos_policy_id":"ffc9b0cd-f4db-4db3-ac82-9be3401e3a53"
}
}响应示例
{
"floatingip":{
"router_id":null,
"status":"DOWN",
"description":"",
"tenant_id":"cf8d21b7fc084813a0481fb9bf331357",
"created_at":"2021-02-25T06:13:07Z",
"updated_at":"2021-02-25T06:30:49Z",
"extra_fields":{
"bandwidth":2048
},
"floating_network_id":"096c7e01-28ab-46e5-9427-1444f6f67a12",
"fixed_ip_address":null,
"floating_ip_address":"172.16.10.131",
"revision_number":5,
"project_id":"cf8d21b7fc084813a0481fb9bf331357",
"port_id":null,
"id":"145c964a-1951-4a34-b62f-441e0d3e2675",
"qos_policy_id":"ffc9b0cd-f4db-4db3-ac82-9be3401e3a53"
}
}删除floatingip
功能介绍
删除公网ip。
URI
DELETE /v2.0/floatingips/[floatingip id]
请求消息
| 参数 | 是否可选 | 参数类型 | 描述 |
|---|---|---|---|
| floatingip | 否 | object | floatingip对象 |
请求示例
DELETE /v2.0/floatingips/145c964a-1951-4a34-b62f-441e0d3e2675
响应消息
| 参数 | 参数类型 | 描述 |
|---|---|---|
| description | String | 人类可读的防火墙策略名称。 |
| id | String | 防火墙策略ID。 |
| firewall_rules | array | 与防火墙策略相关联的防火墙规则id列表。 |
| name | String | 人类可读的防火墙策略名称。 |
| project_id | String | 资源所属项目的ID。 |
| shared | boolean | 设置为true可使该防火墙策略对其他项目可见。默认是false。 |
| tenant_id | String | 资源所属项目的ID。 |
响应示例
{
"firewall_policy": {
"name": "test-policy-update",
"firewall_rules": [],
"tenant_id": "89f60564953c48068513503e4cf4b12f",
"id": "b8d2c21e-586f-4212-aecb-aa11ca919003",
"shared": false,
"project_id": "89f60564953c48068513503e4cf4b12f",
"audited": false,
"description": ""
}
}正常响应代码
200
错误码
400，401，404
绑定floatingip
功能描述
绑定公网ip给port。
URL
PUT /v2.0/floatingips/{floatingip_id}
请求消息
| 参数 | 是否可选 | 参数类型 |
|---|---|---|
| floatingip_id | 否 | floatingip ID。 |
| port_id | 否 | 绑定的port ID。 |
请求示例
PUT /v2.0/floatingips/db926c28-b166-4636-b157-2434da8db796{"floatingip":{"port_id": "1f471606-3c23-4faa-a2b6-ecb67125a77b"}}
响应消息
无
响应示例
无
正常响应代码
200
解绑floatingip
功能描述
port解绑公网ip。
URL
PUT /v2.0/floatingips/{floatingip_id}
请求消息
| 参数 | 是否可选 | 参数类型 |
|---|---|---|
| floatingip_id | 否 | floatingip ID。 |
请求示例
PUT /v2.0/floatingips/db926c28-b166-4636-b157-2434da8db796{"floatingip": {"port_id": null}}
响应消息
无
响应示例
无
正常响应代码
200
