diff options
author | Jakub Guzik <jakubmguzik@gmail.com> | 2021-08-09 23:57:26 +0200 |
---|---|---|
committer | Jakub Guzik <jakubmguzik@gmail.com> | 2021-08-10 22:10:40 +0200 |
commit | ed30ae4a8aacf87cb9be3cfed2e43499cb4d8649 (patch) | |
tree | 7cbad58484441f0c658abed34bbfc0ae61c5b169 /pkg/api/server | |
parent | 6513adda185986c1994d2a2d354b874aee7543e6 (diff) | |
download | podman-ed30ae4a8aacf87cb9be3cfed2e43499cb4d8649.tar.gz podman-ed30ae4a8aacf87cb9be3cfed2e43499cb4d8649.tar.bz2 podman-ed30ae4a8aacf87cb9be3cfed2e43499cb4d8649.zip |
Add until filter to podman pod ps
This commit adds additional until filter to podman pod ps (ls/list).
Additionally, it also adds descriptions for podman pod ps filters available
via http api.
Signed-off-by: Jakub Guzik <jakubmguzik@gmail.com>
Diffstat (limited to 'pkg/api/server')
-rw-r--r-- | pkg/api/server/register_pods.go | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/pkg/api/server/register_pods.go b/pkg/api/server/register_pods.go index 3bcc50ba4..58234005e 100644 --- a/pkg/api/server/register_pods.go +++ b/pkg/api/server/register_pods.go @@ -17,7 +17,18 @@ func (s *APIServer) registerPodsHandlers(r *mux.Router) error { // - in: query // name: filters // type: string - // description: needs description and plumbing for filters + // description: | + // JSON encoded value of the filters (a map[string][]string) to process on the pods list. Available filters: + // - `id=<pod-id>` Matches all of pod id. + // - `label=<key>` or `label=<key>:<value>` Matches pods based on the presence of a label alone or a label and a value. + // - `name=<pod-name>` Matches all of pod name. + // - `until=<timestamp>` List pods created before this timestamp. The `<timestamp>` can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. `10m`, `1h30m`) computed relative to the daemon machine’s time. + // - `status=<pod-status>` Pod's status: `stopped`, `running`, `paused`, `exited`, `dead`, `created`, `degraded`. + // - `network=<pod-network>` Name or full ID of network. + // - `ctr-names=<pod-ctr-names>` Container name within the pod. + // - `ctr-ids=<pod-ctr-ids>` Container ID within the pod. + // - `ctr-status=<pod-ctr-status>` Container status within the pod. + // - `ctr-number=<pod-ctr-number>` Number of containers in the pod. // responses: // 200: // $ref: "#/responses/ListPodsResponse" |