python-novaclient/releasenotes/notes/deprecate-network-cli-f0a539528be594d3.yaml
Matt Riedemann 578c39865d Deprecate network-* commands and clamp to microversion 2.35
This introduces a helper to clamp the client microversion to 2.35,
which is the last version to support the network proxy. We print a
deprecation warning if those commands are used, and mark them as
deprecated in the help text.

This is a network-specific user-friendly bit of sugar to make sure
that nova-network users aren't cut out before we actually drop the
support for it on the server side.

Note that quotas and limits are special because only the network
related resources in those are not returned with 2.36. So this
change handles 2.36 separately for quota-update and
quota-class-update, and deprecates the network resource quota
update arguments for <2.35 as an indication those are going away.

As expected, several of the functional tests have to be updated
to work with the new world that is microversion 2.36.

Related to blueprint deprecate-api-proxies

Co-Authored-By: Matt Riedemann <mriedem@us.ibm.com>

Change-Id: Id68c2dbef29b201aa7c8ef9417432feb5596529a
2016-08-19 09:30:29 -07:00

68 lines
1.9 KiB
YAML

---
upgrade:
- |
The ability to update the following network-related resources via the
``nova quota-update`` and ``nova quota-class-update`` commands is now
deprecated:
* Fixed IPs
* Floating IPs
* Security Groups
* Security Group Rules
By default the quota and limits CLIs will not update or show those
resources using microversion >= 2.36. You can still use them, however, by
specifying ``--os-compute-api-version 2.35``. Quota information for network
resources should be retrieved from python-neutronclient or
python-openstackclient.
deprecations:
- |
The following commands are now deprecated:
* dns-create
* dns-create-private-domain
* dns-create-public-domain
* dns-delete
* dns-delete-domain
* dns-domains
* dns-list
* fixed-ip-get
* fixed-ip-reserve
* fixed-ip-unreserve
* floating-ip-create
* floating-ip-delete
* floating-ip-list
* floating-ip-pool-list
* floating-ip-bulk-create
* floating-ip-bulk-delete
* floating-ip-bulk-list
* network-create
* network-delete
* network-disassociate
* network-associate-host
* network-associate-project
* network-list
* network-show
* scrub
* secgroup-create
* secgroup-delete
* secgroup-list
* secgroup-update
* secgroup-add-group-rule
* secgroup-delete-group-rule
* secgroup-add-rule
* secgroup-delete-rule
* secgroup-list-rules
* secgroup-list-default-rules
* secgroup-add-default-rule
* secgroup-delete-default-rule
* tenant-network-create
* tenant-network-delete
* tenant-network-list
* tenant-network-show
With the 2.36 microversion these will fail in the API. The CLI will
fallback to passing the 2.35 microversion to ease the transition. Network
resource information should be retrieved from python-neutronclient or
python-openstackclient.