File: index.rst

package info (click to toggle)
python-ironic-inspector-client 5.4.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 592 kB
  • sloc: python: 2,082; makefile: 15; sh: 2
file content (43 lines) | stat: -rw-r--r-- 1,141 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
Library User Reference
======================

To use Python API first create a ``ClientV1`` object::

    import ironic_inspector_client
    client = ironic_inspector_client.ClientV1(session=keystone_session)

This code creates a client with API version *1.0* and a given `Keystone
session`_.  The service URL is fetched from the service catalog in this case.
See :py:class:`ironic_inspector_client.ClientV1` documentation for details.

.. _api-versioning:

API Versioning
--------------

Starting with version 2.1.0 **Ironic Inspector** supports optional API
versioning. Version is a tuple (X, Y), where X is always 1 for now.

The server has maximum and minimum supported versions. If no version is
requested, the server assumes the maximum it's supported.

Two constants are exposed for convenience:

* :py:const:`ironic_inspector_client.DEFAULT_API_VERSION`
* :py:const:`ironic_inspector_client.MAX_API_VERSION`


API Reference
-------------

.. toctree::
   :maxdepth: 2

   api/ironic_inspector_client

.. toctree::
   :hidden:

   api/modules

.. _Keystone session: https://docs.openstack.org/keystoneauth/latest/using-sessions.html