From 9fc393615f6aae1a70ba282123ee15afc23a6297 Mon Sep 17 00:00:00 2001 From: Yong Tang Date: Wed, 1 Feb 2017 19:05:54 -0800 Subject: [PATCH] Update API history and man page for `--filter expose/publish` This fix updates API history and man page for `docker ps --filter expose/publish`, from the feedback: https://github.com/docker/docker/pull/27557#issuecomment-276832876 Signed-off-by: Yong Tang --- docs/api/version-history.md | 1 + man/src/container/ls.md | 14 ++++++++++++++ 2 files changed, 15 insertions(+) diff --git a/docs/api/version-history.md b/docs/api/version-history.md index c8ad6ce831..2e45f19f3c 100644 --- a/docs/api/version-history.md +++ b/docs/api/version-history.md @@ -19,6 +19,7 @@ keywords: "API, Docker, rcli, REST, documentation" * `GET /containers/(id or name)/attach/ws` now returns WebSocket in binary frame format for API version >= v1.26, and returns WebSocket in text frame format for API version< v1.26, for the purpose of backward-compatibility. * `GET /networks` is optimised only to return list of all networks and network specific information. List of all containers attached to a specific network is removed from this API and is only available using the network specific `GET /networks/{network-id}. +* `GET /containers/json` now supports `publish` and `expose` filters to filter containers that expose or publish certain ports. ## v1.25 API changes diff --git a/man/src/container/ls.md b/man/src/container/ls.md index f233cecd63..5cb63079ec 100644 --- a/man/src/container/ls.md +++ b/man/src/container/ls.md @@ -16,6 +16,8 @@ Filter output based on these conditions: - volume=(|) - network=(|) - containers connected to the provided network - health=(starting|healthy|unhealthy|none) - filters containers based on healthcheck status + - publish=([/]|/[]) - filters containers based on published ports + - expose=([/]|/[]) - filters containers based on exposed ports ## Format @@ -94,3 +96,15 @@ Filter output based on these conditions: $ docker container ls --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}" CONTAINER ID MOUNTS 9c3527ed70ce remote-volume + +## Display containers that have published port of 80: + + $ docker ps --filter publish=80 + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + fc7e477723b7 busybox "top" About a minute ago Up About a minute 0.0.0.0:32768->80/tcp admiring_roentgen + +## Display containers that have exposed TCP port in the range of `8000-8080`: + + $ docker ps --filter expose=8000-8080/tcp + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + 9833437217a5 busybox "top" 21 seconds ago Up 19 seconds 8080/tcp dreamy_mccarthy