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

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"


              }


         ]


     }
]

HISTORY

August 2018, Originally compiled by Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩