2016-04-12 09:03:46 -04:00
|
|
|
.. -*- rst -*-
|
|
|
|
|
2016-06-14 15:31:18 +09:00
|
|
|
======================================
|
|
|
|
Fixed IPs (os-fixed-ips) (DEPRECATED)
|
|
|
|
======================================
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
|
|
|
These APIs are proxy calls to the Network service. Nova has
|
|
|
|
deprecated all the proxy APIs and users should use the native APIs
|
2016-12-10 15:57:14 +08:00
|
|
|
instead. These will fail with a 404 starting from microversion 2.36.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Shows data for a fixed IP, such as host name, CIDR, and address. Also,
|
2016-05-06 12:29:48 -04:00
|
|
|
reserves and releases a fixed IP address.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Show Fixed Ip Details
|
|
|
|
=====================
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
.. rest_method:: GET /os-fixed-ips/{fixed_ip}
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Shows details for a fixed IP address.
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
Normal response codes: 200
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-05-06 12:29:48 -04:00
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNotFound(404)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-06-06 15:49:15 -04:00
|
|
|
- fixed_ip: fixed_ip_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-06-06 15:49:15 -04:00
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- fixed_ip: fixed_ip_obj
|
|
|
|
- address: ip_address
|
|
|
|
- cidr: cidr
|
|
|
|
- host: fixed_ip_host
|
|
|
|
- hostname: fixed_ip_hostname
|
2016-09-09 20:21:47 +08:00
|
|
|
- reserved: reserved_fixedip
|
2016-06-06 15:49:15 -04:00
|
|
|
|
|
|
|
|
2016-04-19 17:52:18 +09:00
|
|
|
**Example Show Fixed Ip Details: JSON response**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-04-20 11:05:26 +09:00
|
|
|
.. literalinclude:: ../../doc/api_samples/os-fixed-ips/fixedips-get-resp.json
|
2016-04-12 09:03:46 -04:00
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
Reserve Or Release A Fixed Ip
|
|
|
|
=============================
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
.. rest_method:: POST /os-fixed-ips/{fixed_ip}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Reserves or releases a fixed IP.
|
|
|
|
|
2016-06-06 15:49:15 -04:00
|
|
|
To reserve a fixed IP address, specify ``reserve`` in the request body.
|
|
|
|
To release a fixed IP address, specify ``unreserve`` in the request body.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-05-06 12:29:48 -04:00
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNotFound(404)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-06-06 15:49:15 -04:00
|
|
|
- fixed_ip: fixed_ip_path
|
|
|
|
- reserve: action_reserve
|
|
|
|
- unreserve: action_unreserve
|
2016-06-02 08:50:03 -04:00
|
|
|
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
**Example Reserve Or Release A Fixed Ip: JSON request**
|
|
|
|
|
2016-04-20 11:05:26 +09:00
|
|
|
.. literalinclude:: ../../doc/api_samples/os-fixed-ips/fixedip-post-req.json
|
2016-04-12 09:03:46 -04:00
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-06-29 14:41:05 -07:00
|
|
|
There is no body content for the response of a successful POST operation.
|