Skip to content

Commit 3ba1dda

Browse files
yongtangyongtang
authored
Merge pull request #35343 from thaJeztah/bump-api-version-1.35
Bump API version to 1.35
2 parents 3ab20a8 + ba6b5aa commit 3ba1dda

2 files changed

Lines changed: 24 additions & 11 deletions

File tree

‎api/swagger.yaml‎

Lines changed: 21 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,10 @@ produces:
1919
consumes:
2020
- "application/json"
2121
- "text/plain"
22-
basePath: "/v1.34"
22+
basePath: "/v1.35"
2323
info:
2424
title: "Docker Engine API"
25-
version: "1.34"
25+
version: "1.35"
2626
x-logo:
2727
url: "https://docs.docker.com/images/logo-docker-main.png"
2828
description: |
@@ -42,22 +42,32 @@ info:
4242
4343
# Versioning
4444
45-
The API is usually changed in each release of Docker, so API calls are versioned to ensure that clients don't break.
45+
The API is usually changed in each release, so API calls are versioned to
46+
ensure that clients don't break. To lock to a specific version of the API,
47+
you prefix the URL with its version, for example, call `/v1.30/info` to use
48+
the v1.30 version of the `/info` endpoint. If the API version specified in
49+
the URL is not supported by the daemon, a HTTP `400 Bad Request` error message
50+
is returned.
4651
47-
For Docker Engine 17.10, the API version is 1.33. To lock to this version, you prefix the URL with `/v1.33`. For example, calling `/info` is the same as calling `/v1.33/info`.
52+
If you omit the version-prefix, the current version of the API (v1.35) is used.
53+
For example, calling `/info` is the same as calling `/v1.35/info`. Using the
54+
API without a version-prefix is deprecated and will be removed in a future release.
4855
49-
Engine releases in the near future should support this version of the API, so your client will continue to work even if it is talking to a newer Engine.
56+
Engine releases in the near future should support this version of the API,
57+
so your client will continue to work even if it is talking to a newer Engine.
5058
51-
In previous versions of Docker, it was possible to access the API without providing a version. This behaviour is now deprecated will be removed in a future version of Docker.
59+
The API uses an open schema model, which means server may add extra properties
60+
to responses. Likewise, the server will ignore any extra query parameters and
61+
request body properties. When you write clients, you need to ignore additional
62+
properties in responses to ensure they do not break when talking to newer
63+
daemons.
5264
53-
If the API version specified in the URL is not supported by the daemon, a HTTP `400 Bad Request` error message is returned.
54-
55-
The API uses an open schema model, which means server may add extra properties to responses. Likewise, the server will ignore any extra query parameters and request body properties. When you write clients, you need to ignore additional properties in responses to ensure they do not break when talking to newer Docker daemons.
56-
57-
This documentation is for version 1.34 of the API. Use this table to find documentation for previous versions of the API:
65+
This documentation is for version v1.35 of the API. Use this table to find
66+
documentation for previous versions of the API:
5867
5968
Docker version | API version | Changes
6069
----------------|-------------|---------
70+
17.11.x | [1.34](https://docs.docker.com/engine/api/v1.34/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-34-api-changes)
6171
17.10.x | [1.33](https://docs.docker.com/engine/api/v1.33/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-33-api-changes)
6272
17.09.x | [1.32](https://docs.docker.com/engine/api/v1.32/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-32-api-changes)
6373
17.07.x | [1.31](https://docs.docker.com/engine/api/v1.31/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-31-api-changes)

‎docs/api/version-history.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,9 @@ keywords: "API, Docker, rcli, REST, documentation"
1313
will be rejected.
1414
-->
1515

16+
## v1.35 API changes
17+
18+
1619
## v1.34 API changes
1720

1821
[Docker Engine API v1.34](https://docs.docker.com/engine/api/v1.34/) documentation

0 commit comments

Comments
 (0)