Swarm vs. Engine response codes

You are viewing docs for legacy standalone Swarm. These topics describe standalone Docker Swarm. If you use Docker 1.12 or 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 and Swarm mode CLI commands. 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

Feedback? Suggestions? Can't find something in the docs?
Edit this page ● Request docs changes ● Get support
Rate this page: