NAME

       podman-pod-inspect - Displays 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

   --latest, -l
       Instead of providing the pod name or ID, use the last created pod. If you use methods other  than  Podman
       to  run  pods  such as CRI-O, the last started pod could be from either of those methods. (This option is
       not available with the remote Podman client)

   --format=format, -f
       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                     │
       ├───────────────────┼─────────────────────────────────┤
       │ .ID               │ Pod   ID                        │
       ├───────────────────┼─────────────────────────────────┤
       │ .Name             │ Pod   name                      │
       ├───────────────────┼─────────────────────────────────┤
       │ .State            │ Pod   state                     │
       ├───────────────────┼─────────────────────────────────┤
       │ .Hostname         │ Pod   hostname                  │
       ├───────────────────┼─────────────────────────────────┤
       │ .Labels           │ Pod   labels                    │
       ├───────────────────┼─────────────────────────────────┤
       │ .Created          │ Time when the pod was created   │
       ├───────────────────┼─────────────────────────────────┤
       │ .CreateCgroup     │ Whether cgroup was created      │
       ├───────────────────┼─────────────────────────────────┤
       │ .CgroupParent     │ Pod   cgroup parent             │
       ├───────────────────┼─────────────────────────────────┤
       │ .CgroupPath       │ Pod   cgroup path               │
       ├───────────────────┼─────────────────────────────────┤
       │ .CreateInfra      │ Whether infrastructure created  │
       ├───────────────────┼─────────────────────────────────┤
       │ .InfraContainerID │ Pod   infrastructure ID         │
       ├───────────────────┼─────────────────────────────────┤
       │ .SharedNamespaces │ Pod   shared namespaces         │
       ├───────────────────┼─────────────────────────────────┤
       │ .NumContainers    │ Number of containers in the pod │
       ├───────────────────┼─────────────────────────────────┤
       │ .Containers       │ Pod   containers                │
       └───────────────────┴─────────────────────────────────┘

EXAMPLE

              # 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"
                        }
                   ]
              }

SEE ALSO

       podman(1),podman-pod(1), podman-inspect(1)

HISTORY

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

                                                                                         podman-pod-inspect(1)()