Skip to content

Commit ae6f09b

Browse files
thaJeztahthaJeztah
committed
deprecate "top-level" network information in NetworkSettings
When inspecting a container, `NetworkSettings` contains top-level information about the default ("bridge") network; `EndpointID`, `Gateway`, `GlobalIPv6Address`, `GlobalIPv6PrefixLen`, `IPAddress`, `IPPrefixLen`, `IPv6Gateway`, and `MacAddress`. These properties are deprecated in favor of per-network properties in `NetworkSettings.Networks`. These properties were already "deprecated" in docker 1.9, but kept around for backward compatibility. Refer to [moby#17538](moby#17538) for further information. This officially deprecates these properties, and marks them for removal in 1.16 Signed-off-by: Sebastiaan van Stijn <[email protected]>
1 parent 95c898d commit ae6f09b

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

‎docs/deprecated.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,26 @@ The following list of features are deprecated in Engine.
2020
To learn more about Docker Engine's deprecation policy,
2121
see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy).
2222

23+
24+
### Top-level network properties in NetworkSettings
25+
26+
**Deprecated In Release: v1.13.0**
27+
28+
**Target For Removal In Release: v1.16**
29+
30+
When inspecting a container, `NetworkSettings` contains top-level information
31+
about the default ("bridge") network;
32+
33+
`EndpointID`, `Gateway`, `GlobalIPv6Address`, `GlobalIPv6PrefixLen`, `IPAddress`,
34+
`IPPrefixLen`, `IPv6Gateway`, and `MacAddress`.
35+
36+
These properties are deprecated in favor of per-network properties in
37+
`NetworkSettings.Networks`. These properties were already "deprecated" in
38+
docker 1.9, but kept around for backward compatibility.
39+
40+
Refer to [#17538](https://github.com/docker/docker/pull/17538) for further
41+
information.
42+
2343
## `filter` param for `/images/json` endpoint
2444
**Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/tag/v1.13.0)**
2545

0 commit comments

Comments
 (0)