1podman-pod-inspect(1) General Commands Manual podman-pod-inspect(1)
2
6 podman-pod-inspect - Displays information describing a pod
7
10 podman pod inspect [options] pod ...
11
14 Displays configuration and state information about a given pod. It
15 also displays information about containers that belong to the pod.
16
19 --format, -f=format
20 Change the default output format. This can be of a supported type like
21 'json' or a Go template. Valid placeholders for the Go template are
22 listed below:
23 ┌─────────────────────┬────────────────────────────────┐
26 │Placeholder │ Description │
27 ├─────────────────────┼────────────────────────────────┤
28 │.BlkioDeviceReadBps │ Block I/O Device Read, in │
29 │ │ bytes/sec │
30 ├─────────────────────┼────────────────────────────────┤
31 │.BlkioDeviceWriteBps │ Block I/O Device Read, in │
32 │ │ bytes/sec │
33 ├─────────────────────┼────────────────────────────────┤
34 │.BlkioWeight │ Block I/O Weight │
35 ├─────────────────────┼────────────────────────────────┤
36 │.BlkioWeightDevice │ Block I/O Device Weight │
37 ├─────────────────────┼────────────────────────────────┤
38 │.CgroupParent │ Pod cgroup parent │
39 ├─────────────────────┼────────────────────────────────┤
40 │.CgroupPath │ Pod cgroup path │
41 ├─────────────────────┼────────────────────────────────┤
42 │.Containers │ Pod containers │
43 ├─────────────────────┼────────────────────────────────┤
44 │.CPUPeriod │ CPU period │
45 ├─────────────────────┼────────────────────────────────┤
46 │.CPUQuota │ CPU quota │
47 ├─────────────────────┼────────────────────────────────┤
48 │.CPUSetCPUs │ CPU Set CPUs │
49 ├─────────────────────┼────────────────────────────────┤
50 │.CPUSetMems │ CPU Set Mems │
51 ├─────────────────────┼────────────────────────────────┤
52 │.CPUShares │ CPU Shares │
53 ├─────────────────────┼────────────────────────────────┤
54 │.CreateCgroup │ Whether cgroup was created │
55 ├─────────────────────┼────────────────────────────────┤
56 │.CreateCommand │ Create command │
57 ├─────────────────────┼────────────────────────────────┤
58 │.Created │ Time when the pod was created │
59 ├─────────────────────┼────────────────────────────────┤
60 │.CreateInfra │ Whether infrastructure created │
61 ├─────────────────────┼────────────────────────────────┤
62 │.Devices │ Devices │
63 ├─────────────────────┼────────────────────────────────┤
64 │.ExitPolicy │ Exit policy │
65 ├─────────────────────┼────────────────────────────────┤
66 │.Hostname │ Pod hostname │
67 ├─────────────────────┼────────────────────────────────┤
68 │.ID │ Pod ID │
69 ├─────────────────────┼────────────────────────────────┤
70 │.InfraConfig ... │ Infra config (contains further │
71 │ │ fields) │
72 ├─────────────────────┼────────────────────────────────┤
73 │.InfraContainerID │ Pod infrastructure ID │
74 ├─────────────────────┼────────────────────────────────┤
75 │.InspectPodData ... │ Nested structure, for experts │
76 │ │ only │
77 ├─────────────────────┼────────────────────────────────┤
78 │.Labels │ Pod labels │
79 ├─────────────────────┼────────────────────────────────┤
80 │.MemoryLimit │ Memory limit, bytes │
81 ├─────────────────────┼────────────────────────────────┤
82 │.MemorySwap │ Memory swap limit, in bytes │
83 ├─────────────────────┼────────────────────────────────┤
84 │.Mounts │ Mounts │
85 ├─────────────────────┼────────────────────────────────┤
86 │.Name │ Pod name │
87 ├─────────────────────┼────────────────────────────────┤
88 │.Namespace │ Namespace │
89 ├─────────────────────┼────────────────────────────────┤
90 │.NumContainers │ Number of containers in the │
91 │ │ pod │
92 ├─────────────────────┼────────────────────────────────┤
93 │.SecurityOpts │ Security options │
94 ├─────────────────────┼────────────────────────────────┤
95 │.SharedNamespaces │ Pod shared namespaces │
96 ├─────────────────────┼────────────────────────────────┤
97 │.State │ Pod state │
98 ├─────────────────────┼────────────────────────────────┤
99 │.VolumesFrom │ Volumes from │
100 └─────────────────────┴────────────────────────────────┘
101 --latest, -l
103 Instead of providing the pod name or ID, use the last created pod. If
104 you use methods other than Podman to run pods such as CRI-O, the last
105 started pod could be from either of those methods. (This option is not
106 available with the remote Podman client, including Mac and Windows (ex‐
107 cluding WSL2) machines)
108
111 # podman pod inspect foobar
112 {
113 "Id": "3513ca70583dd7ef2bac83331350f6b6c47d7b4e526c908e49d89ebf720e4693",
115 "Name": "foobar",
116 "Labels": {},
117 "CgroupParent": "/libpod_parent",
118 "CreateCgroup": true,
119 "Created": "2018-08-08T11:15:18.823115347-05:00"
120 "State": "created",
121 "Hostname": "",
122 "SharedNamespaces": [
123 "uts",
124 "ipc",
125 "net"
126 ]
127 "CreateInfra": false,
128 "InfraContainerID": "1020dd70583dd7ff2bac83331350f6b6e007de0d026c908e49d89ebf891d4699"
129 "CgroupPath": ""
130 "Containers": [
131 {
132 "id": "d53f8bf1e9730281264aac6e6586e327429f62c704abea4b6afb5d8a2b2c9f2c",
133 "state": "configured"
134 }
135 ]
136 }
137
141 podman(1), podman-pod(1), podman-inspect(1)
142
145 August 2018, Originally compiled by Brent Baude bbaude@redhat.com
146 ⟨mailto:bbaude@redhat.com⟩
147 podman-pod-inspect(1)