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. (This option is  not
23       available with the remote Podman client)
24
25
26   --format=format, -f
27       Change the default output format.  This can be of a supported type like
28       'json' or a Go template.  Valid placeholders for the  Go  template  are
29       listed below:
30
31
32       ┌──────────────────┬────────────────────────────────┐
33       │Placeholder       │ Description                    │
34       ├──────────────────┼────────────────────────────────┤
35       │.ID               │ Pod   ID                       │
36       ├──────────────────┼────────────────────────────────┤
37       │.Name             │ Pod   name                     │
38       ├──────────────────┼────────────────────────────────┤
39       │.State            │ Pod   state                    │
40       ├──────────────────┼────────────────────────────────┤
41       │.Hostname         │ Pod   hostname                 │
42       ├──────────────────┼────────────────────────────────┤
43       │.Labels           │ Pod   labels                   │
44       ├──────────────────┼────────────────────────────────┤
45       │.Created          │ Time when the pod was created  │
46       ├──────────────────┼────────────────────────────────┤
47       │.CreateCgroup     │ Whether cgroup was created     │
48       ├──────────────────┼────────────────────────────────┤
49       │.CgroupParent     │ Pod   cgroup parent            │
50       ├──────────────────┼────────────────────────────────┤
51       │.CgroupPath       │ Pod   cgroup path              │
52       ├──────────────────┼────────────────────────────────┤
53       │.CreateInfra      │ Whether infrastructure created │
54       ├──────────────────┼────────────────────────────────┤
55       │.InfraContainerID │ Pod   infrastructure ID        │
56       ├──────────────────┼────────────────────────────────┤
57       │.SharedNamespaces │ Pod   shared namespaces        │
58       ├──────────────────┼────────────────────────────────┤
59       │.NumContainers    │ Number  of  containers  in the │
60       │                  │ pod                            │
61       ├──────────────────┼────────────────────────────────┤
62       │.Containers       │ Pod   containers               │
63       └──────────────────┴────────────────────────────────┘
64

EXAMPLE

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

SEE ALSO

96       podman(1),podman-pod(1), podman-inspect(1)
97
98

HISTORY

100       August 2018,  Originally  compiled  by  Brent  Baude  bbaude@redhat.com
101       ⟨mailto:bbaude@redhat.com⟩
102
103
104
105                                                       podman-pod-inspect(1)()