Exceptions & Warnings¶
API Errors¶
These errors are triggered from an HTTP response that isn’t 2XX:
-
class
elasticsearch.ApiError(message: str, meta: elastic_transport.ApiResponseMeta, body: Any, errors: Tuple[Exception, ...] = ())¶ -
error¶ Backwards-compatible way to access
self.message
-
info¶ Backwards-compatible way to access
self.body
-
status_code¶ Backwards-compatible way to access
self.meta.status
-
-
class
elasticsearch.NotFoundError(message: str, meta: elastic_transport.ApiResponseMeta, body: Any, errors: Tuple[Exception, ...] = ())¶ Exception representing a 404 status code.
-
class
elasticsearch.ConflictError(message: str, meta: elastic_transport.ApiResponseMeta, body: Any, errors: Tuple[Exception, ...] = ())¶ Exception representing a 409 status code.
-
elasticsearch.RequestError¶ alias of
elasticsearch.BadRequestError
-
class
elasticsearch.AuthenticationException(message: str, meta: elastic_transport.ApiResponseMeta, body: Any, errors: Tuple[Exception, ...] = ())¶ Exception representing a 401 status code.
-
class
elasticsearch.AuthorizationException(message: str, meta: elastic_transport.ApiResponseMeta, body: Any, errors: Tuple[Exception, ...] = ())¶ Exception representing a 403 status code.
-
class
elasticsearch.UnsupportedProductError(message: str, meta: elastic_transport.ApiResponseMeta, body: Any, errors: Tuple[Exception, ...] = ())¶ Error which is raised when the client detects it’s not connected to a supported product.
Transport and Connection Errors¶
These errors are triggered by an error occurring before an HTTP response arrives:
-
class
elasticsearch.TransportError(message: Any, errors: Tuple[Exception, ...] = ())¶ Generic exception for the ‘elastic-transport’ package.
For the ‘errors’ attribute, errors are ordered from most recently raised (index=0) to least recently raised (index=N)
If an HTTP status code is available with the error it will be stored under ‘status’. If HTTP headers are available they are stored under ‘headers’.
-
class
elasticsearch.SerializationError(message: Any, errors: Tuple[Exception, ...] = ())¶ Error that occurred during the serialization or deserialization of an HTTP message body
-
class
elasticsearch.ConnectionError(message: Any, errors: Tuple[Exception, ...] = ())¶ Error raised by the HTTP connection
-
class
elasticsearch.ConnectionTimeout(message: Any, errors: Tuple[Exception, ...] = ())¶ Connection timed out during an operation
-
elasticsearch.SSLError¶ alias of
elastic_transport.TlsError