Provided by: podman_3.4.4+ds1-1ubuntu1_amd64
NAME
podman-pod-ps - Prints out information about pods
SYNOPSIS
podman pod ps [options]
DESCRIPTION
podman pod ps lists the pods on the system. By default it lists: · pod id · pod name · the time the pod was created · number of containers attached to pod · container id of the pod infra container · status of pod as defined by the following table ┌────────┬──────────────────────────────────┐ │Status │ Description │ ├────────┼──────────────────────────────────┤ │Created │ No containers running nor │ │ │ stopped │ ├────────┼──────────────────────────────────┤ │Running │ at least one container is │ │ │ running │ ├────────┼──────────────────────────────────┤ │Stopped │ At least one container stopped │ │ │ and none running │ ├────────┼──────────────────────────────────┤ │Exited │ All containers stopped in pod │ ├────────┼──────────────────────────────────┤ │Dead │ Error retrieving state │ └────────┴──────────────────────────────────┘
OPTIONS
--ctr-names Display the container names --ctr-ids Display the container IDs --ctr-status Display the container statuses --latest, -l Show the latest pod created (all states) (This option is not available with the remote Podman client) --noheading Omit the table headings from the listing of pods. --no-trunc Display the extended information --ns Display namespace information of the pod --quiet, -q Print the numeric IDs of the pods only --format=format Pretty-print containers to JSON or using a Go template Valid placeholders for the Go template are listed below: ┌────────────────────┬──────────────────────────────────┐ │Placeholder │ Description │ ├────────────────────┼──────────────────────────────────┤ │.ID │ Container ID │ ├────────────────────┼──────────────────────────────────┤ │.Name │ Name of pod │ ├────────────────────┼──────────────────────────────────┤ │.Status │ Status of pod │ ├────────────────────┼──────────────────────────────────┤ │.Labels │ All the labels assigned to the │ │ │ pod │ ├────────────────────┼──────────────────────────────────┤ │.NumberOfContainers │ Show the number of containers │ │ │ attached to pod │ ├────────────────────┼──────────────────────────────────┤ │.Cgroup │ Cgroup path of pod │ ├────────────────────┼──────────────────────────────────┤ │.Created │ Creation time of pod │ ├────────────────────┼──────────────────────────────────┤ │.InfraID │ Pod infra container ID │ ├────────────────────┼──────────────────────────────────┤ │.Networks │ Show all networks connected to │ │ │ the infra container │ └────────────────────┴──────────────────────────────────┘ --sort Sort by created, ID, name, status, or number of containers Default: created --filter, -f=filter Filter output based on conditions given. Multiple filters can be given with multiple uses of the --filter flag. Filters with the same key work inclusive with the only exception being label which is exclusive. Filters with different keys always work exclusive. Valid filters are listed below: ┌───────────┬─────────────────────────────────────────────────────────────────────────┐ │Filter │ Description │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │id │ [ID] Pod's ID (accepts regex) │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │name │ [Name] Pod's name (accepts regex) │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │label │ [Key] or [Key=Value] Label assigned to a container │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │until │ Only list pods created before given timestamp │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │status │ Pod's status: stopped, running, paused, exited, dead, created, degraded │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │network │ [Network] name or full ID of network │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │ctr-names │ Container name within the pod (accepts regex) │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │ctr-ids │ Container ID within the pod (accepts regex) │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │ctr-status │ Container status within the pod │ ├───────────┼─────────────────────────────────────────────────────────────────────────┤ │ctr-number │ Number of containers in the pod │ └───────────┴─────────────────────────────────────────────────────────────────────────┘ --help, -h Print usage statement
EXAMPLES
$ podman pod ps POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 1 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 2 $ podman pod ps --ctr-names POD ID NAME STATUS CREATED INFRA ID NAMES 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 loving_archimedes f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a thirsty_hawking,wizardly_golick $ podman pod ps --ctr-status --ctr-names --ctr-ids POD ID NAME STATUS CREATED INFRA ID IDS NAMES STATUS 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 ba465ab0a3a4 loving_archimedes running f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 331693bff40a,8e428daeb89e thirsty_hawking,wizardly_golick configured,configured $ podman pod ps --format "{{.ID}} {{.ContainerNames}} {{.Cgroup}}" 00dfd6fa02c0 loving_archimedes /libpod_parent f4df8692e116 thirsty_hawking,wizardly_golick /libpod_parent $ podman pod ps --sort id --filter ctr-number=2 POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 2 $ podman pod ps --ctr-ids POD ID NAME STATUS CREATED INFRA ID IDS 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 ba465ab0a3a4 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 331693bff40a,8e428daeb89e $ podman pod ps --no-trunc --ctr-ids POD ID NAME STATUS CREATED INFRA ID IDS 00dfd6fa02c0a2daaedfdf8fcecd06f22ad114d46d167d71777224735f701866 jolly_goldstine Running 31 hours ago ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050 ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050 f4df8692e116a3e6d1d62572644ed36ca475d933808cc3c93435c45aa139314b nifty_torvalds Created 10 minutes ago 331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0 331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0,8e428daeb89e69b71e7916a13accfb87d122889442b5c05c2d99cf94a3230e9d $ podman pod ps --ctr-names POD ID NAME STATUS CREATED INFRA ID NAMES 314f4da82d74 hi Created 17 hours ago a9f2d2165675 jovial_jackson,hopeful_archimedes,vibrant_ptolemy,heuristic_jennings,keen_raman,hopeful_newton,mystifying_bose,silly_lalande,serene_lichterman ...
pod ps
Print a list of pods
SEE ALSO
podman-pod(1)
HISTORY
July 2018, Originally compiled by Peter Hunt pehunt@redhat.com ⟨mailto:pehunt@redhat.com⟩ podman-pod-ps(1)()