/usr/share/doc/python-elasticsearch-doc/html/_sources/api.txt is in python-elasticsearch-doc 1.2.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 | .. _api:
API Documentation
=================
All the API calls map the raw REST api as closely as possible, including the
distinction between required and optional arguments to the calls. This means
that the code makes distinction between positional and keyword arguments; we,
however, recommend that people **use keyword arguments for all calls for
consistency and safety**.
An API call is considered successful (and will return a response) if
elasticsearch returns a 2XX response. Otherwise an instance of
:class:`~elasticsearch.TransportError` (or a more specific subclass) will be
raised. You can see other exception and error states in :ref:`exceptions`. If
you do not wish an exception to be raised you can always pass in an ``ignore``
parameter with either a single status code that should be ignored or a list of
them::
from elasticsearch import Elasticsearch
es = Elasticsearch()
# ignore 400 cause by IndexAlreadyExistsException when creating an index
es.indices.create(index='test-index', ignore=400)
# ignore 404 and 400
es.indices.delete(index='test-index', ignore=[400, 404])
You can also specify ``request_timeout`` (float) as part of any API call, this
value will get passed to the ``perform_request`` method of the connection
class::
# only wait for 1 second, regardless of the client's default
es.cluster.health(wait_for_status='yellow', request_timeout=1)
.. note::
for compatibility with the Python ecosystem we use ``from_`` instead of
``from`` and ``doc_type`` instead of ``type`` as parameter names.
.. py:module:: elasticsearch
Elasticsearch
-------------
.. autoclass:: Elasticsearch
:members:
.. py:module:: elasticsearch.client
Indices
-------
.. autoclass:: IndicesClient
:members:
Cluster
-------
.. autoclass:: ClusterClient
:members:
Nodes
-----
.. autoclass:: NodesClient
:members:
Cat
---
.. autoclass:: CatClient
:members:
Snapshot
---
.. autoclass:: SnapshotClient
:members:
|