Provided by: podman_4.9.3+ds1-1ubuntu0.2_amd64 
NAME
podman-pod-inspect - Display 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 │
├──────────────────────┼───────────────────────────────────────┤
│ .LockNumber │ Number of the pod's Libpod lock │
├──────────────────────┼───────────────────────────────────────┤
│ .MemoryLimit │ Memory limit, bytes │
├──────────────────────┼───────────────────────────────────────┤
│ .MemorySwap │ Memory swap limit, in bytes │
├──────────────────────┼───────────────────────────────────────┤
│ .Mounts │ Mounts │
├──────────────────────┼───────────────────────────────────────┤
│ .Name │ Pod name │
├──────────────────────┼───────────────────────────────────────┤
│ .Namespace │ Namespace │
├──────────────────────┼───────────────────────────────────────┤
│ .NumContainers │ Number of containers in the pod │
├──────────────────────┼───────────────────────────────────────┤
│ .RestartPolicy │ Restart policy of 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. Note: the last started pod can be
from other users of Podman on the host machine. (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)