IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Release notes
editRelease notes
edit- 8.4.3 (2022-10-06)
- 8.4.2 (2022-09-20)
- 8.4.1 (2022-09-06)
- 8.4.0 (2022-08-25)
- 8.3.3 (2022-08-01)
- 8.3.2 (2022-08-01)
- 8.3.1 (2022-06-30)
- 8.3.0 (2022-06-29)
- 8.2.3 (2022-06-15)
- 8.2.2 (2022-06-01)
- 8.2.1 (2022-06-01)
- 8.2.0 (2022-05-03)
- 8.1.2 (2022-03-30)
- 8.1.1 (2022-03-22)
- 8.1.0 (2022-03-08)
- 8.0.0 (2022-02-10)
8.4.3 (2022-10-06)
edit- Client is compatible with Elasticsearch 8.4.3
8.4.2 (2022-09-20)
editDocuments
edit-
Added the
error_trace
,filter_path
,human
andpretty
parameters to theget_source
API. -
Added the
ext
parameter to thesearch
API.
Async Search
edit-
Added the
ext
parameter to theasync_search.submit
API.
Fleet
edit-
Added the
ext
parameter to thefleet.search
API.
8.4.1 (2022-09-06)
edit- Client is compatible with Elasticsearch 8.4.1
8.4.0 (2022-08-25)
editSearch
edit-
Added the
knn
parameter to thesearch
API. -
Added the
knn
parameter to theasync_search.submit
API.
Machine Learning
edit-
Added the
cache_size
parameter to theml.start_trained_model_deployment
API.
Security
edit-
Added the
security.update_api_key
API.
8.3.3 (2022-08-01)
edit- Client is compatible with Elasticsearch 8.3.3
8.3.2 (2022-08-01)
editSecurity
edit-
Added the
refresh
parameter to thesecurity.create_service_token
API.
8.3.1 (2022-06-30)
editSecurity
edit-
Added the experimental
security.has_privileges_user_profile
API. -
Added the
hint
parameter to the experimentalsecurity.suggest_user_profiles
API.
8.3.0 (2022-06-29)
edit- Client is compatible with Elasticsearch 8.3.0
8.2.3 (2022-06-15)
editDocuments
edit-
Added the
routing
parameter to themsearch
API.
CAT
edit-
Added the
cat.component_templates
API.
Ingest
edit-
Added the
if_version
parameter to theingest.put_pipeline
API.
Security
edit-
Changed the
name
parameter for thesecurity.create_service_token
API from required to optional. -
Added the
refresh
parameter to thesecurity.create_service_token
API. -
Changed the name of
access
parameter to thelabels
parameter in thesecurity.update_user_profile_data
API.
Shutdown
edit-
Added the
timeout
andmaster_timeout
parameters to theshutdown.get_node
,shutdown.delete_node
, andshutdown.put_node
APIs. -
Added the
reason
,type
,allocation_delay
, andtarget_node_name
parameters to theshutdown.put_node
API.
8.2.2 (2022-06-01)
edit- Client is compatible with Elasticsearch 8.2.2
8.2.1 (2022-06-01)
editMachine Learning
edit-
Added the
inference_config
parameter to theml.infer_trained_model_deployment
API
8.2.0 (2022-05-03)
editClient
edit-
Re-introduced support for passing
requests.auth.BaseAuth
objects to thehttp_auth
parameter which was available in 7.x.
Search
edit-
Added the
filter
parameter to the experimentalknn_search
API
Documents
edit-
Changed the
source
anddest
parameters for thereindex
API from optional to required
Indices
edit-
Added the
indices.field_usage_stats
API -
Added the
indices.modify_data_stream
API -
Added the
fields
andtypes
parameters to thefield_caps
API -
Added the
ignore_unvailable
parameter to theopen_point_in_time
API -
Added the
master_timeout
andtimeout
parameters to theindices.delete
API -
Added the
features
parameter to theindices.get
API
Machine Learning
edit-
Added the
ml.get_memory_stats
API
Migrations
edit-
Added the
migrations.get_feature_upgrade_status
API -
Added the
migrations.post_feature_upgrade
API
Nodes
edit-
Added the
nodes.clear_repositories_metering_archive
API -
Added the
nodes.get_repositories_metering_info
API
Security
edit-
Added the beta
security.activate_user_profile
API -
Added the beta
security.disable_user_profile
API -
Added the beta
security.enable_user_profile
API -
Added the beta
security.get_user_profile
API -
Added the beta
security.suggest_user_profiles
API -
Added the beta
security.update_user_profile_data
API
SQL
edit-
Added the
catalog
,index_using_frozen
,keep_alive
,keep_on_completion
,runtime_mappings
, andwait_for_completion_timeout
parameters to thesql.query
API
8.1.2 (2022-03-30)
edit- Client is compatible with Elasticsearch 8.1.2
8.1.1 (2022-03-22)
editDocuments
edit-
Changed the
source
anddest
parameters of thereindex
API to be required.
Mappings
edit-
Changed the
fields
parameter of thefield_caps
API to be required.
8.1.0 (2022-03-08)
editTransforms
edit-
Added the
transform.reset_transform
API
8.0.0 (2022-02-10)
editAdded
edit-
Added the top-level
.options()
method toElasticsearch
andAsyncElasticsearch
for modifying transport options. - Added parameters corresponding to JSON request body fields for all APIs
-
Added
basic_auth
parameter for specifying username and password authentication -
Added
bearer_auth
parameter for specifying an HTTP bearer token or service token -
Added the
meta
property toApiError
to access the HTTP response metadata of an error. -
Added a check that a compatible version of the
elastic-transport
package is installed.
Changed
edit-
Changed the transport layer to use the
elastic-transport
package -
Changed user-defined
body
parameters to have semantic names (e.gindex(document={...})
instead ofindex(body={...})
). -
Changed responses to be objects with two properties,
meta
for response metadata (HTTP status, headers, node, etc) andbody
for a typed body. -
Changed
AsyncElasticsearch
to always be available, regardless of whetheraiohttp
is installed -
Changed exception hierarchy, the major change is a new exception
ApiError
which differentiates between an error that’s raised from the transport layer (previouslyelasticsearch.exceptions.TransportError
, nowelastic_transport.TransportError
) and one raised from the API layer -
Changed the name of
JSONSerializer
toJsonSerializer
for consistency with other serializer names. Added an alias to the old name for backwards compatibility -
Changed the default mimetypes (
application/json
) to instead use compatibility mimetypes (application/vnd.elasticsearch+json
) which always request for responses compatibility with version 8.x.
Removed
edit- Removed support for Python 2.7 and Python 3.5, the library now supports only Python 3.6+
-
Removed the
elasticsearch.connection
module as all functionality has been moved to theelastic-transport
package -
Removed the default URL of
http://localhost:9200
due to Elasticsearch 8.0 default configuration beinghttps://localhost:9200
. The client’s connection to Elasticsearch now must be specified with scheme, host, and port or with thecloud_id
parameter - Removed the ability to use positional arguments with API methods. Going forward all API parameters must be keyword-only parameters
-
Removed the
doc_type
,include_type_name
, andcopy_settings
parameters from many document and index APIs
Deprecated
edit-
Deprecated the
body
andparams
parameters on all APIs -
Deprecated setting transport options
http_auth
,api_key
,ignore
,request_timeout
,headers
, andopaque_id
All of these settings should instead be set via the.options()
method -
Deprecated the
elasticsearch.transport
andelasticsearch.client
modules. These modules will be removed in a future version
CAT
edit-
Removed the deprecated
local
parameter from thecat.indices
,cat.nodes
,cat.shards
API -
Removed the deprecated
allow_no_datafeeds
parameter from thecat.ml_datafeeds
API -
Removed the deprecated
allow_no_jobs
parameter from thecat.ml_jobs
API -
Removed the deprecated
size
parameter from thecat.thread_pool
API -
Added the
time
parameter to thecat.thread_pool
API
Documents
edit-
Removed the deprecated
size
parameter from thedelete_by_query
API -
Removed the deprecated
size
parameter from theupdate_by_query
API
Indices
edit-
Removed the deprecated
indices.flush_synced
API -
Removed the deprecated
indices.freeze
API -
Removed the deprecated
indices.get_upgrade
API -
Removed the deprecated
indices.upgrade
API -
Removed the deprecated
indices.exist_type
API -
Removed the deprecated parameter
copy_settings
from theindices.shrink
API -
Deprecated the
verbose
parameter of theindices.segments
API
License / X-Pack
edit-
Deprecated the
accept_enterprise
parameter of thelicense.get
API -
Deprecated the
accept_enterprise
parameter of thexpack.info
API
Machine Learning
edit-
Added the experimental
ml.infer_trained_model_deployment
API -
Added the experimental
ml.put_trained_model_definition_part
API -
Added the experimental
ml.put_trained_model_vocabulary
API -
Added the experimental
ml.start_trained_model_deployment
API -
Added the experimental
ml.stop_trained_model_deployment
API -
Added the
timeout
parameter to theml.delete_trained_model
API -
Removed the deprecated
allow_no_jobs
parameter from theml.close_job
API -
Removed the deprecated
ml.find_text_structure
API -
Removed the deprecated
allow_no_datafeeds
parameter from theml.get_datafeed_stats
API -
Removed the deprecated
allow_no_datafeeds
parameter from theml.get_datafeeds
API -
Removed the deprecated
allow_no_jobs
parameter from theml.get_job_stats
API -
Removed the deprecated
allow_no_jobs
parameter from theml.get_jobs
API -
Removed the deprecated
allow_no_jobs
parameter from theml.get_overall_buckets
API
Search
edit-
Added the experimental
knn_search
API
Searchable Snapshots
edit-
Removed the deprecated
searchable_snapshots.repository_stats
API
Snapshots
edit-
Changed the
snapshot.delete
API to accept multiple snapshots
Security
edit-
Added the
security.enroll_kibana
API -
Added the
security.enroll_node
API