From fc50bad3c208718cc62ae5859c362497a39d30f7 Mon Sep 17 00:00:00 2001 From: Ben Firshman Date: Thu, 27 Oct 2016 17:59:59 +0100 Subject: [PATCH] Deprecate API calls without a version See #21157 for more details. In a future version of Docker, providing a version to API calls will be mandatory. An implementation of this is in #27801. Signed-off-by: Ben Firshman --- docs/deprecated.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/deprecated.md b/docs/deprecated.md index 90a8909c11..c7d3611804 100644 --- a/docs/deprecated.md +++ b/docs/deprecated.md @@ -226,3 +226,12 @@ Since 1.9, Docker Content Trust Offline key has been renamed to Root key and the **Deprecated In Release: v1.13.0** `MAINTAINER` was an early very limited form of `LABEL` which should be used instead. + +### API calls without a version +**Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/)** + +**Target For Removal In Release: v1.16** + +API versions should be supplied to all API calls to ensure compatibility with +future Engine versions. Instead of just requesting, for example, the URL +`/containers/json`, you must now request `/v1.25/containers/json`.