Swarm vs. Engine response codes

You are viewing docs for legacy standalone Swarm. These topics describe standalone Docker Swarm. In Docker 1.12 and higher, Swarm mode is integrated with Docker Engine. Most users should use integrated Swarm mode — a good place to start is Getting started with swarm mode, Swarm mode CLI commands, and the Get started with Docker walkthrough). Standalone Docker Swarm is not integrated into the Docker Engine API and CLI commands.

Docker Engine provides a REST API for making calls to the Engine daemon. Docker Swarm allows a caller to make the same calls to a cluster of Engine daemons. While the API calls are the same, the API response status codes do differ. This document explains the differences.

Four methods are included, and they are GET, POST, PUT, and DELETE.

The comparison is based on api v1.22, and all Docker Status Codes in api v1.22 are referenced from docker-remote-api-v1.22.

GET

• Route: /_ping
• Handler: ping

• Route: /events
• Handler: getEvents

• Route: /info
• Handler: getInfo

• Route: /version
• Handler: getVersion

• Route: /images/json
• Handler: getImagesJSON

• Route: /images/viz
• Handler: notImplementedHandler

• Route: /images/search
• Handler: proxyRandom

• Route: /images/get
• Handler: getImages

• Route: /images/{name:.*}/get
• Handler: proxyImageGet

• Route: /images/{name:.*}/history
• Handler: proxyImage

• Route: /images/{name:.*}/json
• Handler: proxyImage

• Route: /containers/ps
• Handler: getContainersJSON

• Route: /containers/json
• Handler: getContainersJSON

• Route: /containers/{name:.*}/archive
• Handler: proxyContainer

• Route: /containers/{name:.*}/export
• Handler: proxyContainer

• Route: /containers/{name:.*}/changes
• Handler: proxyContainer

• Route: /containers/{name:.*}/json
• Handler: getContainerJSON

• Route: /containers/{name:.*}/top
• Handler: proxyContainer

• Route: /containers/{name:.*}/logs
• Handler: proxyContainer

• Route: /containers/{name:.*}/stats
• Handler: proxyContainer

• Route: /containers/{name:.*}/attach/ws
• Handler: proxyHijack

• Route: /exec/{execid:.*}/json
• Handler: proxyContainer

• Route: /networks
• Handler: getNetworks

• Route: /networks/{networkid:.*}
• Handler: getNetwork

• Route: /volumes
• Handler: getVolumes

• Route: /volumes/{volumename:.*}
• Handler: getVolume

POST

• Route: /auth
• Handler: proxyRandom

• Route: /commit
• Handler: postCommit

• Route: /build
• Handler: postBuild

• Route: /images/create
• Handler: postImagesCreate

• Route: /images/load
• Handler: postImagesLoad

• Route: /images/{name:.*}/push
• Handler: proxyImagePush

• Route: /images/{name:.*}/tag
• Handler: postTagImage

• Route: /containers/create
• Handler: postContainersCreate

• Route: /containers/{name:.*}/kill
• Handler: proxyContainerAndForceRefresh

• Route: /containers/{name:.*}/pause
• Handler: proxyContainerAndForceRefresh

• Route: /containers/{name:.*}/unpause
• Handler: proxyContainerAndForceRefresh

• Route: /containers/{name:.*}/rename
• Handler: postRenameContainer

• Route: /containers/{name:.*}/restart
• Handler: proxyContainerAndForceRefresh

• Route: /containers/{name:.*}/start
• Handler: postContainersStart

• Route: /containers/{name:.*}/stop
• Handler: proxyContainerAndForceRefresh

• Route: /containers/{name:.*}/update
• Handler: proxyContainerAndForceRefresh

• Route: /containers/{name:.*}/wait
• Handler: proxyContainerAndForceRefresh

• Route: /containers/{name:.*}/resize
• Handler: proxyContainer

• Route: /containers/{name:.*}/attach
• Handler: proxyHijack

• Route: /containers/{name:.*}/copy
• Handler: proxyContainer

• Route: /containers/{name:.*}/exec
• Handler: postContainersExec

• Route: /exec/{execid:.*}/start
• Handler: postExecStart

• Route: /exec/{execid:.*}/resize
• Handler: proxyContainer

• Route: /networks/create
• Handler: postNetworksCreate

• Route: /networks/{networkid:.*}/connect
• Handler: proxyNetworkConnect

• Route: /networks/{networkid:.*}/disconnect
• Handler: proxyNetworkDisconnect

• Route: /volumes/create
• Handler: postVolumesCreate

PUT

• Route: /containers/{name:.*}/archive"
• Handler: proxyContainer

DELETE

• Route: /containers/{name:.*}
• Handler: deleteContainers

• Route: /images/{name:.*}
• Handler: deleteImages

• Route: /networks/{networkid:.*}
• Handler: deleteNetworks

• Route: /volumes/{name:.*}"
• Handler: deleteVolumes