René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"ListImagesCmd#withImageNameFilter is not working anymore with Docker API 1.41+","articleBody":"Hello, \n\nwe noticed recently a regression after upgrading the version of Docker in one of our machine related to a test using `ListImagesCmd#withImageNameFilter` to find if a docker image was locally present before creating it. \n\nSo, for example, I have locally an image named `xwiki-tomcat-jre25-office:b372e3023b3b21630385b22e1b19c70eaef70364988917e6d27613341c951536`, which also has a specific label `\"image-version\": \"LO-25.2.7\"`. If I use the CLI to search for an image with a name containing a different hash such as: \n\n\u003e docker images xwiki-tomcat-jre25-office:71af718ae80d90b93c3b3c36eb9b0cf9e102e845b260d1f1e33a07fbda511322 --filter \"label=image-version=LO-25.2.7\"\n\nThen the command line properly returns no result. \n\nHowever, when I use the following snippet using docker-java: \n```\nDockerClient dockerClient = DockerClientImpl.getInstance(config, httpClient);\n        List\u003cImage\u003e imageList = dockerClient.listImagesCmd()\n            .withImageNameFilter(\n                \"xwiki-tomcat-jre25-office:71af718ae80d90b93c3b3c36eb9b0cf9e102e845b260d1f1e33a07fbda511322\")\n            .withLabelFilter(Map.of(\"image-version\", \"LO-25.2.7\"))\n            .exec();\n```\nI now obtain in the list one occurence, the image \n`xwiki-tomcat-jre25-office:b372e3023b3b21630385b22e1b19c70eaef70364988917e6d27613341c951536`, while I'm expecting the list to be empty. And before the upgrade of the Docker packages on the machine, the list was empty. \n\nAfter investigation this is apparently because docker-java performs the following request:\n\u003e 11:27:14.576 [main] TRACE o.t.s.c.g.d.c.exec.ListImagesCmdExec - GET: DefaultWebTarget{path=[/images/json], queryParams={filter=[xwiki-tomcat-jre25-office:71af718ae80d90b93c3b3c36eb9b0cf9e102e845b260d1f1e33a07fbda511322], filters=[{\"label\":[\"image-version=LO-25.2.7\"]}]}}\n\nYou can note the presence of `queryParams={filter=[xwiki-tomcat-jre25-office:71af718ae80d90b93c3b3c36eb9b0cf9e102e845b260d1f1e33a07fbda511322]`. And apparently this `filter` query param has been removed from Docker API since version 1.41, see [in release notes](https://docs.docker.com/reference/api/engine/version-history/#v141-api-changes): \n\u003e The filter (singular) query parameter, which was deprecated in favor of the filters option in Docker 1.13, has now been removed from the GET /images/json endpoint. The parameter remains available when using API version 1.40 or below.\n\nSo IMO the `ListImagesCmd#withImageNameFilter` API is now broken with recent versions of Docker API. Either it should be fixed, or at the very least it should be deprecated / some javadoc should be added to inform that it might not work as expected. ","author":{"url":"https://github.com/surli","@type":"Person","name":"surli"},"datePublished":"2025-12-12T13:16:55.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/2557/docker-java/issues/2557"}