docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

chore: use dynamic api version in example 

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
David Karlsson 2024-11-08 12:04:33 +01:00
parent 9eeb171a81
commit 473a19c720
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
content/reference/api/engine/_index.md
View File

@ -99,15 +99,21 @@ You can specify the API version to use in any of the following ways:
that incorporates the API version with the features you need. that incorporates the API version with the features you need.
- When using `curl` directly, specify the version as the first part of the URL. - When using `curl` directly, specify the version as the first part of the URL.
For instance, if the endpoint is `/containers/` you can use For instance, if the endpoint is `/containers/` you can use
`/v1.47/containers/`. `/v{{% param "latest_engine_api_version" %}}/containers/`.
- To force the Docker CLI or the Docker Engine SDKs to use an older version - To force the Docker CLI or the Docker Engine SDKs to use an older version
of the API than the version reported by `docker version`, set the of the API than the version reported by `docker version`, set the
environment variable `DOCKER_API_VERSION` to the correct version. This works environment variable `DOCKER_API_VERSION` to the correct version. This works
on Linux, Windows, or macOS clients. on Linux, Windows, or macOS clients.
{{% apiVersionPrevious.inline %}}
{{- $version := site.Params.latest_engine_api_version }}
{{- $parts := strings.Split $version "." }}
{{- $major := cast.ToInt (index $parts 0) }}
{{- $minor := cast.ToInt (index $parts 1) }}
```console ```console
$ DOCKER_API_VERSION=1.46 $ DOCKER_API_VERSION={{ $major }}.{{ math.Sub $minor 1 }}
``` ```
{{% /apiVersionPrevious.inline %}}
While the environment variable is set, that version of the API is used, even While the environment variable is set, that version of the API is used, even
if the Docker daemon supports a newer version. This environment variable if the Docker daemon supports a newer version. This environment variable