# How does ES version map to the official clients (e.g. python)?

**URL:** <https://discuss.elastic.co/t/how-does-es-version-map-to-the-official-clients-e-g-python/13803>\
**Category:** Elasticsearch\
**Created:** [September 30, 2013, 10:24am UTC](https://discuss.elastic.co/t/how-does-es-version-map-to-the-official-clients-e-g-python/13803 "2013-09-30T10:24:22Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Tikitu\_de\_Jager](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/tikitu_de_jager/32/1258_2.png) [@Tikitu\_de\_Jager](https://discuss.elastic.co/u/Tikitu_de_Jager)\
**Post date:** [September 30, 2013, 10:24am UTC](https://discuss.elastic.co/t/how-does-es-version-map-to-the-official-clients-e-g-python/13803/1 "2013-09-30T10:24:22Z")

</div>

Hi folks,

Great news about the official clients! Something I didn't find in the  
release info, or the docs for the client I'm interested in (Python): is  
there a policy for how the clients will track changes to the REST API over  
different ES versions? (I'm thinking especially of the 1.0 release, of  
course, but there are already some changes that are relevant for us from  
0.20 to 0.90.) Will separate client versions be maintained for older ES  
versions (if so: how far back?), or some sort of compatibility mode, or  
similar? If not, it would be great if there could be some simple mapping  
from ES version numbers to the compatible client versions: any chance?

Cheers,  
Tikitu

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

**Author:** ![jprante](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/jprante/32/44941_2.png) [@jprante](https://discuss.elastic.co/u/jprante)\
**Post date:** [September 30, 2013, 10:42am UTC](https://discuss.elastic.co/t/how-does-es-version-map-to-the-official-clients-e-g-python/13803/2 "2013-09-30T10:42:45Z")

</div>

+1

Jörg

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

**Author:** ![Clinton\_Gormley](https://avatars.discourse-cdn.com/v4/letter/c/50afbb/32.png) [@Clinton\_Gormley](https://discuss.elastic.co/u/Clinton_Gormley)\
**Post date:** [September 30, 2013, 10:53am UTC](https://discuss.elastic.co/t/how-does-es-version-map-to-the-official-clients-e-g-python/13803/3 "2013-09-30T10:53:09Z")

</div>

Hi Tikitu

The current official clients target v0.90.\* and higher, although most  
things will work in previous versions as well. Obviously the clients  
provide support for some features that are only available in more recent  
versions of Elasticsearch, and these will fail if you try to use them with  
older versions.

The intention, going forward, is to retain backward compatibility. There  
are a number of things in the API which we want to clean up for 1.0, but we  
hope to do that in a way that doesn't break compat with older versions.

If we come across the situation where we have to break with the past, then  
we will cross that bridge then, probably with a compatibility list between  
client and ES versions

Clint

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

**Author:** ![Tikitu\_de\_Jager](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/tikitu_de_jager/32/1258_2.png) [@Tikitu\_de\_Jager](https://discuss.elastic.co/u/Tikitu_de_Jager)\
**Post date:** [September 30, 2013, 11:02am UTC](https://discuss.elastic.co/t/how-does-es-version-map-to-the-official-clients-e-g-python/13803/4 "2013-09-30T11:02:21Z")

</div>

Thanks Clint for the quick reply and the info.  
Tikitu

On Monday, 30 September 2013 12:53:09 UTC+2, Clinton Gormley wrote:

> Hi Tikitu
> 
> The current official clients target v0.90.\* and higher, although most  
> things will work in previous versions as well. Obviously the clients  
> provide support for some features that are only available in more recent  
> versions of Elasticsearch, and these will fail if you try to use them with  
> older versions.
> 
> The intention, going forward, is to retain backward compatibility. There  
> are a number of things in the API which we want to clean up for 1.0, but we  
> hope to do that in a way that doesn't break compat with older versions.
> 
> If we come across the situation where we have to break with the past, then  
> we will cross that bridge then, probably with a compatibility list between  
> client and ES versions
> 
> Clint

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\
**Post date:** [July 6, 2017, 2:14am UTC](https://discuss.elastic.co/t/how-does-es-version-map-to-the-official-clients-e-g-python/13803/5 "2017-07-06T02:14:16Z")

</div>


