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       │                  │                                │
65       └──────────────────┴────────────────────────────────┘
66

EXAMPLE

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

SEE ALSO

98       podman-pod(1), podman-pod-ps(1)
99
100

HISTORY

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