1podman-pod-inspect(1)()                                podman-pod-inspect(1)()
2
3
4

NAME

6       podman-pod-inspect - Displays information describing a pod
7
8

SYNOPSIS

10       podman pod inspect [options] pod ...
11
12

DESCRIPTION

14       Displays  configuration  and  state  information about a given pod.  It
15       also displays information about containers that belong to the pod.
16
17

OPTIONS

19   --latest, -l
20       Instead of providing the pod name or ID, use the last created  pod.  If
21       you  use  methods other than Podman to run pods such as CRI-O, the last
22       started pod could be from either of those methods.
23
24
25       The latest option is not supported on the remote client.
26
27
28   --format=format, -f
29       Change the default output format.  This can be of a supported type like
30       'json'  or  a  Go template.  Valid placeholders for the Go template are
31       listed below:
32
33
34       ┌──────────────────┬────────────────────────────────┐
35       │Placeholder       │ Description                    │
36       ├──────────────────┼────────────────────────────────┤
37       │.ID               │ Pod   ID                       │
38       ├──────────────────┼────────────────────────────────┤
39       │.Name             │ Pod   name                     │
40       ├──────────────────┼────────────────────────────────┤
41       │.State            │ Pod   state                    │
42       ├──────────────────┼────────────────────────────────┤
43       │.Hostname         │ Pod   hostname                 │
44       ├──────────────────┼────────────────────────────────┤
45       │.Labels           │ Pod   labels                   │
46       ├──────────────────┼────────────────────────────────┤
47       │.Created          │ Time when the pod was created  │
48       ├──────────────────┼────────────────────────────────┤
49       │.CreateCgroup     │ Whether cgroup was created     │
50       ├──────────────────┼────────────────────────────────┤
51       │.CgroupParent     │ Pod   cgroup parent            │
52       ├──────────────────┼────────────────────────────────┤
53       │.CgroupPath       │ Pod   cgroup path              │
54       ├──────────────────┼────────────────────────────────┤
55       │.CreateInfra      │ Whether infrastructure created │
56       ├──────────────────┼────────────────────────────────┤
57       │.InfraContainerID │ Pod   infrastructure ID        │
58       ├──────────────────┼────────────────────────────────┤
59       │.SharedNamespaces │ Pod   shared namespaces        │
60       ├──────────────────┼────────────────────────────────┤
61       │.NumContainers    │ Number of  containers  in  the │
62       │                  │ pod                            │
63       ├──────────────────┼────────────────────────────────┤
64       │.Containers       │ Pod   containers               │
65       ├──────────────────┼────────────────────────────────┤
66       │                  │                                │
67       └──────────────────┴────────────────────────────────┘
68

EXAMPLE

70              # podman pod inspect foobar
71              {
72
73                   "Id": "3513ca70583dd7ef2bac83331350f6b6c47d7b4e526c908e49d89ebf720e4693",
74                   "Name": "foobar",
75                   "Labels": {},
76                   "CgroupParent": "/libpod_parent",
77                   "CreateCgroup": true,
78                   "Created": "2018-08-08T11:15:18.823115347-05:00"
79                   "State": "created",
80                   "Hostname": "",
81                   "SharedNamespaces": [
82                        "uts",
83                        "ipc",
84                        "net"
85                   ]
86                   "CreateInfra": false,
87                   "InfraContainerID": "1020dd70583dd7ff2bac83331350f6b6e007de0d026c908e49d89ebf891d4699"
88                   "CgroupPath": ""
89                   "Containers": [
90                        {
91                             "id": "d53f8bf1e9730281264aac6e6586e327429f62c704abea4b6afb5d8a2b2c9f2c",
92                             "state": "configured"
93                        }
94                   ]
95              }
96
97
98

SEE ALSO

100       podman-pod(1), podman-pod-ps(1)
101
102

HISTORY

104       August  2018,  Originally  compiled  by  Brent  Baude bbaude@redhat.com
105       ⟨mailto:bbaude@redhat.com⟩
106
107
108
109                                                       podman-pod-inspect(1)()