Files
python-designateclient/doc/source/index.rst
Graham Hayes 7cd8b69fc2 Highlight V1 API removal
Update Docs and the execption logged to point users to the
openstack cli + v2 client.

Change-Id: Ib08330d348a6a2f0e976ab0df26e91b2d7bd4e13
2018-02-12 14:01:22 +00:00

46 lines
1.2 KiB
ReStructuredText

======================
python-designateclient
======================
python-designateclient provides python bindings and command line tools for both
Designate v1 and v2 APIs.
The :ref:`Python API bindings <bindings>` are provided by the
:program:`designateclient` module.
There are two separate command line interfaces to work with the two API
versions:
v2: the designate plugin for the :program:`openstack` command line tool. More information can be
found on the :ref:`designate v2 command line tool page <shell-v2>`.
v1: the :program:`designate` command line tool. More information can be found
on the :ref:`designate v1 command line tool page <shell>`.
.. warning::
The V1 API was removed in Queens, and cannot be re-enabled.
The :program:`designate` command line tool will no longer function on
installs newer than Queens.
You'll need credentials for an OpenStack cloud that implements the Designate
API in order to use the client.
.. toctree::
:maxdepth: 1
install/index
user/index
cli/index
contributor/index
reference/index
.. rubric:: Indices and tables
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
.. _Cloud DNS: http://www.hpcloud.com/products-services/dns