Sponsor:

Your company here, and a link to your site. Click to find out more.

podman-pod-inspect - Man Page

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:

PlaceholderDescription
.BlkioDeviceReadBpsBlock I/O Device Read, in bytes/sec
.BlkioDeviceWriteBpsBlock I/O Device Read, in bytes/sec
.BlkioWeightBlock I/O Weight
.BlkioWeightDeviceBlock I/O Device Weight
.CgroupParentPod cgroup parent
.CgroupPathPod cgroup path
.ContainersPod containers
.CPUPeriodCPU period
.CPUQuotaCPU quota
.CPUSetCPUsCPU Set CPUs
.CPUSetMemsCPU Set Mems
.CPUSharesCPU Shares
.CreateCgroupWhether cgroup was created
.CreateCommandCreate command
.Created ...Time when the pod was created
.CreateInfraWhether infrastructure created
.DevicesDevices
.ExitPolicyExit policy
.HostnamePod hostname
.IDPod ID
.InfraConfig ...Infra config (contains further fields)
.InfraContainerIDPod infrastructure ID
.InspectPodData ...Nested structure, for experts only
.Labels ...Pod labels
.LockNumberNumber of the pod's Libpod lock
.MemoryLimitMemory limit, bytes
.MemorySwapMemory swap limit, in bytes
.MountsMounts
.NamePod name
.NamespaceNamespace
.NumContainersNumber of containers in the pod
.RestartPolicyRestart policy of the pod
.SecurityOptsSecurity options
.SharedNamespacesPod shared namespaces
.StatePod state
.VolumesFromVolumes 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

Inspect specified pod:

# 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⟩

Referenced By

podman-inspect(1), podman-pod(1).

The man page docker-pod-inspect(1) is an alias of podman-pod-inspect(1).