openstack/openstack-manuals
Code Issues Proposed changes

Add Network IP Availability API Extention

Browse Source 
There was api merged for Network IP Availaibility [1]. This change
basically implements new extension that can be used to check network
usage stats of all the networks or specific network created by neutron.
There is also patch [2] upstream and close to merge for client commands

This patch will add how to configure it and commands used to get that
information.

[1]. https://review.openstack.org/#/c/212955/
[2]. https://review.openstack.org/#/c/269926/

Closes-Bug: #1551907
Change-Id: I5a6df488147240c11a4bad7f03320469bc8a3be6
This commit is contained in:
Manjeet Singh Bhatia 2016-02-10 22:31:54 +00:00
parent 489d25544e
commit daa62d3fff
2 changed files with 60 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
doc/networking-guide/source/adv-config-net-ip-availability.rst Normal file
View File

@ -0,0 +1,59 @@
=========================================
Network IP Availability plug-in extension
=========================================
Network IP Availability is an information-only API extension that allows
a user or process to determine the number of IP addresses that are consumed
across networks and the allocation pools of their subnets. This extension was
added to neutron in the Mitaka release.
This section illustrates how you can get the Network IP address availability
through the command-line interface.
Get Network IP address availability for all IPv4 networks:
.. code-block:: console
$ neutron net-ip-availability-list
+--------------------------------------+--------------+-----------+----------+
| network_id | network_name | total_ips | used_ips |
+--------------------------------------+--------------+-----------+----------+
| 363a611a-b08b-4281-b64e-198d90cb94fd | private | 253 | 3 |
| c92d0605-caf2-4349-b1b8-8d5f9ac91df8 | public | 253 | 1 |
+--------------------------------------+--------------+-----------+----------+
Get Network IP address availability for all IPv6 networks:
.. code-block:: console
$ neutron net-ip-availability-list --ip-version 6
+--------------------------------------+--------------+----------------------+----------+
| network_id | network_name | total_ips | used_ips |
+--------------------------------------+--------------+----------------------+----------+
| 363a611a-b08b-4281-b64e-198d90cb94fd | private | 18446744073709551614 | 3 |
| c92d0605-caf2-4349-b1b8-8d5f9ac91df8 | public | 18446744073709551614 | 1 |
+--------------------------------------+--------------+----------------------+----------+
Get Network IP address availability statistics for a specific network:
.. code-block:: console
$ neutron net-ip-availability-show NETWORKUUID
+------------------------+----------------------------------------------------------------------------------+
| Field | Value |
+------------------------+----------------------------------------------------------------------------------+
| network_id | 363a611a-b08b-4281-b64e-198d90cb94fd |
| network_name | private |
| subnet_ip_availability | {"used_ips": 3, "subnet_id": "843ee06f-b81b-49b0-81e6-2ac38a37a57b" |
| | "subnet_name": "private-subnet", "ip_version": 4, "cidr": "10.0.0.0/24", |
| | "total_ips": 253} |
| | {"used_ips": 3, "subnet_id": "ce5be0cf-fb4c-49e4-9446-7c10592962ff", |
| | "subnet_name": "ipv6-private-subnet", "ip_version": 6, "cidr": |
| | "fd2d:7235:6ead::/64", "total_ips": 18446744073709551614} |
| tenant_id | 644747a9234943d4b4be1b3388ac86ae |
| total_ips | 18446744073709551867 |
| used_ips | 6 |
+------------------------+----------------------------------------------------------------------------------+

1
doc/networking-guide/source/adv-config.rst
View File

@ -19,3 +19,4 @@ Advanced configuration
adv-config-ipam.rst adv-config-ipam.rst
adv-config-availability-zone.rst adv-config-availability-zone.rst
adv-config-dns.rst adv-config-dns.rst
adv-config-net-ip-availability.rst