Provided by: podman_4.3.1+ds1-8ubuntu1_amd64 
NAME
podman-pod-inspect - Displays information describing a pod
SYNOPSIS
podman pod inspect [options] pod ...
DESCRIPTION
Displays configuration and state information about a given pod. It also displays
information about containers that belong to the pod.
OPTIONS
--format, -f=format
Change the default output format. This can be of a supported type like 'json' or a Go
template. Valid placeholders for the Go template are listed below:
┌─────────────────────┬──────────────────────────────────┐
│Placeholder │ Description │
├─────────────────────┼──────────────────────────────────┤
│.BlkioDeviceReadBps │ Block I/O Device Read, in │
│ │ bytes/sec │
├─────────────────────┼──────────────────────────────────┤
│.BlkioDeviceWriteBps │ Block I/O Device Read, in │
│ │ bytes/sec │
├─────────────────────┼──────────────────────────────────┤
│.BlkioWeight │ Block I/O Weight │
├─────────────────────┼──────────────────────────────────┤
│.BlkioWeightDevice │ Block I/O Device Weight │
├─────────────────────┼──────────────────────────────────┤
│.CgroupParent │ Pod cgroup parent │
├─────────────────────┼──────────────────────────────────┤
│.CgroupPath │ Pod cgroup path │
├─────────────────────┼──────────────────────────────────┤
│.Containers │ Pod containers │
├─────────────────────┼──────────────────────────────────┤
│.CPUPeriod │ CPU period │
├─────────────────────┼──────────────────────────────────┤
│.CPUQuota │ CPU quota │
├─────────────────────┼──────────────────────────────────┤
│.CPUSetCPUs │ CPU Set CPUs │
├─────────────────────┼──────────────────────────────────┤
│.CPUSetMems │ CPU Set Mems │
├─────────────────────┼──────────────────────────────────┤
│.CPUShares │ CPU Shares │
├─────────────────────┼──────────────────────────────────┤
│.CreateCgroup │ Whether cgroup was created │
├─────────────────────┼──────────────────────────────────┤
│.CreateCommand │ Create command │
├─────────────────────┼──────────────────────────────────┤
│.Created │ Time when the pod was created │
├─────────────────────┼──────────────────────────────────┤
│.CreateInfra │ Whether infrastructure created │
├─────────────────────┼──────────────────────────────────┤
│.Devices │ Devices │
├─────────────────────┼──────────────────────────────────┤
│.ExitPolicy │ Exit policy │
├─────────────────────┼──────────────────────────────────┤
│.Hostname │ Pod hostname │
├─────────────────────┼──────────────────────────────────┤
│.ID │ Pod ID │
├─────────────────────┼──────────────────────────────────┤
│.InfraConfig ... │ Infra config (contains further │
│ │ fields) │
├─────────────────────┼──────────────────────────────────┤
│.InfraContainerID │ Pod infrastructure ID │
├─────────────────────┼──────────────────────────────────┤
│.InspectPodData ... │ Nested structure, for experts │
│ │ only │
├─────────────────────┼──────────────────────────────────┤
│.Labels │ Pod labels │
├─────────────────────┼──────────────────────────────────┤
│.MemoryLimit │ Memory limit, bytes │
├─────────────────────┼──────────────────────────────────┤
│.MemorySwap │ Memory swap limit, in bytes │
├─────────────────────┼──────────────────────────────────┤
│.Mounts │ Mounts │
├─────────────────────┼──────────────────────────────────┤
│.Name │ Pod name │
├─────────────────────┼──────────────────────────────────┤
│.Namespace │ Namespace │
├─────────────────────┼──────────────────────────────────┤
│.NumContainers │ Number of containers in the pod │
├─────────────────────┼──────────────────────────────────┤
│.SecurityOpts │ Security options │
├─────────────────────┼──────────────────────────────────┤
│.SharedNamespaces │ Pod shared namespaces │
├─────────────────────┼──────────────────────────────────┤
│.State │ Pod state │
├─────────────────────┼──────────────────────────────────┤
│.VolumesFrom │ Volumes from │
└─────────────────────┴──────────────────────────────────┘
--latest, -l
Instead of providing the pod name or ID, use the last created pod. If you use methods
other than Podman to run pods such as CRI-O, the last started pod could be from either of
those methods. (This option is not available with the remote Podman client, including Mac
and Windows (excluding WSL2) machines)
EXAMPLE
# podman pod inspect foobar
{
"Id": "3513ca70583dd7ef2bac83331350f6b6c47d7b4e526c908e49d89ebf720e4693",
"Name": "foobar",
"Labels": {},
"CgroupParent": "/libpod_parent",
"CreateCgroup": true,
"Created": "2018-08-08T11:15:18.823115347-05:00"
"State": "created",
"Hostname": "",
"SharedNamespaces": [
"uts",
"ipc",
"net"
]
"CreateInfra": false,
"InfraContainerID": "1020dd70583dd7ff2bac83331350f6b6e007de0d026c908e49d89ebf891d4699"
"CgroupPath": ""
"Containers": [
{
"id": "d53f8bf1e9730281264aac6e6586e327429f62c704abea4b6afb5d8a2b2c9f2c",
"state": "configured"
}
]
}
SEE ALSO
podman(1), podman-pod(1), podman-inspect(1)
HISTORY
August 2018, Originally compiled by Brent Baude bbaude@redhat.com
⟨mailto:bbaude@redhat.com⟩
podman-pod-inspect(1)