v51

latestSwagger 2.0raw.githubusercontent.com2026-08-01108160461.1 KB

Network

Connect a container to a network

The network must be either a local-scoped network or a swarm-scoped network with the attachable option set. A network cannot be re-attached to a running container

post/networks/{id}/connect

Path parameters

idstring required

Network ID or name

Request body

Containerstring required

The ID or name of the container to connect to the network.

Example request

{
  "Container": "3613f73ba0e4",
  "EndpointConfig": {
    "IPAMConfig": {
      "IPv4Address": "172.20.30.33",
      "IPv6Address": "2001:db8:abcd::3033",
      "LinkLocalIPs": [
        "169.254.34.68",
        "fe80::3468"
      ]
    },
    "Links": [
      "container_1",
      "container_2"
    ],
    "MacAddress": "02:42:ac:11:00:04",
    "Aliases": [
      "server_x",
      "server_y"
    ],
    "DriverOpts": {
      "com.example.some-label": "some-value",
      "com.example.some-other-label": "some-other-value"
    },
    "NetworkID": "08754567f1f40222263eab4102e1c733ae697e8e354aa9cd6e18d7402835292a",
    "EndpointID": "b88f5b905aabf2893f3cbc4ee42d1ea7980bbc0a92e2c8922b1e1795298afb0b",
    "Gateway": "172.17.0.1",
    "IPAddress": "172.17.0.4",
    "IPPrefixLen": 16,
    "IPv6Gateway": "2001:db8:2::100",
    "GlobalIPv6Address": "2001:db8::5689",
    "GlobalIPv6PrefixLen": 64,
    "DNSNames": [
      "foobar",
      "server_x",
      "server_y",
      "my.ctr"
    ]
  }
}

Response

No error