Sebastiaan van Stijn
68b095d4df
API: fix 404 status description on container create
...
This updates the current swagger file, and all docs versions
with the same fix as ff1d9a3ec5
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-07-03 21:30:47 +02:00
Sebastiaan van Stijn
8e2343ffd4
docs: fix NanoCPUs casing
...
While the field in the Go struct is named `NanoCPUs`, it has a JSON label to
use `NanoCpus`, which was added in the original pull request (not clear what
the reason was); 846baf1fd3
Some notes:
- Golang processes field names case-insensitive, so when *using* the API,
both cases should work, but when inspecting a container, the field is
returned as `NanoCpus`.
- This only affects Containers.Resources. The `Limits` and `Reservation`
for SwarmKit services and SwarmKit "nodes" do not override the name
for JSON, so have the canonical (`NanoCPUs`) casing.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-02-10 13:02:27 +01:00
Sebastiaan van Stijn
240d0b37bb
docs: fix double "the" in existing API versions
...
Backport of 2db5676c6e
to the swagger files
used in the documentation
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-01-27 12:24:47 +01:00
Sebastiaan van Stijn
4e8f3bcee1
docs: fix typos in API docs
...
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-01-04 13:17:39 +01:00
Tonis Tiigi
8cc0fd811e
docs: fix builder-version swagger
...
Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com>
2020-10-26 20:17:50 -07:00
Nikolay Edigaryev
7afef854ed
api: clarify "v" option behavior in the container remove endpoint
...
Current description of the "v" option doesn't explain what happens to
the volumes that are still in use by other containers. Turns out that
the only volumes that are removed are unnamed ones[1].
Perhaps a good way of clarifying this behavior would be adapting the
description from "docker rm --help".
As for the docs/api/v1.*.yaml changes — they seem to be applicable,
since the origin of this behavior dates way back to the 2016 or v1.11[2].
[1]: a24a71c50f/daemon/mounts.go (L34-L38)
[2]: dd7d1c8a02
Signed-off-by: Nikolay Edigaryev <edigaryev@gmail.com>
2020-09-23 12:34:52 +03:00
Nikolay Edigaryev
13e0ba700a
swagger: fix MemTotal units in SystemInfo endpoint
...
MemTotal represents bytes, not kilobytes. See Linux[1] and Windows[2]
implementations.
[1]: f50a40e889/pkg/system/meminfo_linux.go (L49)
[2]: f50a40e889/pkg/system/meminfo_windows.go (L40)
Signed-off-by: Nikolay Edigaryev <edigaryev@gmail.com>
2020-09-10 22:15:45 +03:00
Sebastiaan van Stijn
e221931ccd
docs: API v1.40: move system version response to definitions
...
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-07-27 21:03:39 +02:00
Brian Goff
4db39ab1a0
Merge pull request #41267 from thaJeztah/swagger_fix_buildcache_types
2020-07-27 12:02:53 -07:00
Sebastiaan van Stijn
a305abb1d1
docs: API v1.40: fix type for BuildCache CreatedAt and LastUsedAt
...
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-07-27 12:12:25 +02:00
Sebastiaan van Stijn
1e89ca40ba
swagger: sync updates to v1.40
...
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-07-23 13:35:54 +02:00
Sebastiaan van Stijn
01244e85e7
docs: sync API v1.40 swagger formatting with current version
...
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-07-03 15:42:41 +02:00
Sebastiaan van Stijn
6fdbc50084
docs: add API versions v1.25 - v1.29, v1.38 - v1.40
...
Adding separate documents for older API versions, so that these don't have to
be collected from each tag/release branch:
- v1.40 - docker v19.03
- v1.39 - docker v18.09
- v1.38 - docker v18.06
- v1.29 - docker v17.05
- v1.28 - docker v17.04
- v1.27 - docker v17.03
- v1.26 - docker v1.13.1
- v1.25 - docker v1.13.0
Note that:
- API versions v1.30 - v1.37 are yet to be added after the tags and release-
branches from the docker/docker-ce mono-repo have been extracted.
- docker v1.13.0 made the switch from using a markdown file to using swagger
to document the API.
Approach taken:
git mv api/swagger.yaml api/swagger-current.yaml
git checkout upstream/19.03 -- api/swagger.yaml
git mv api/swagger.yaml docs/api/v1.40.yaml
git checkout v18.09.9 -- api/swagger.yaml
git mv api/swagger.yaml docs/api/v1.39.yaml
git checkout v18.06.3-ce -- api/swagger.yaml
git mv api/swagger.yaml docs/api/v1.38.yaml
git checkout v17.05.0-ce -- api/swagger.yaml
git mv api/swagger.yaml docs/api/v1.29.yaml
git checkout v17.04.0-ce -- api/swagger.yaml
git mv api/swagger.yaml docs/api/v1.28.yaml
git checkout v17.03.2-ce -- api/swagger.yaml
git mv api/swagger.yaml docs/api/v1.27.yaml
git checkout v1.13.1 -- api/swagger.yaml
git mv api/swagger.yaml docs/api/v1.26.yaml
git checkout v1.13.0 -- api/swagger.yaml
git mv api/swagger.yaml docs/api/v1.25.yaml
git mv api/swagger-current.yaml api/swagger.yaml
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-02-24 11:00:35 +01:00