Docker Community Forums

Share and learn in the Docker community.

Docker API backwards-compatibility

I started to use the Golang API from github.com/docker/docker (api and client) based on tag 1.13.0.rc2.
I’ve created a 1.24 client, thanks to the version arg of the NewClient() method, which I thought would allow me to talk to any Docker engine from version 1.12 upwards.

Unfortunately because of changes in the ImageList API (the field MatchName has been replaced by a filter named reference I’m not able to list the images from the local cache on a Docker engine 1.12.3.

Can you please confirm if it’s a bug, or if I’m supposed to build my client from the API version of the minimum version of the server the client is supposed to talk to?

will be fixed in 1.13.0-rc3: https://github.com/docker/docker/issues/28895