github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-pod-inspect.1.md (about)

     1  % podman-pod-inspect(1)
     2  
     3  ## NAME
     4  podman\-pod\-inspect - Displays information describing a pod
     5  
     6  ## SYNOPSIS
     7  **podman pod inspect** [*options*] *pod* ...
     8  
     9  ## DESCRIPTION
    10  Displays configuration and state information about a given pod.  It also displays information about containers
    11  that belong to the pod.
    12  
    13  ## OPTIONS
    14  #### **--latest**, **-l**
    15  
    16  Instead of providing the pod name or ID, use the last created pod. If you use methods other than Podman
    17  to run pods such as CRI-O, the last started pod could be from either of those methods.
    18  
    19  The latest option is not supported on the remote client.
    20  
    21  #### **--format**=*format*, **-f**
    22  
    23  Change the default output format.  This can be of a supported type like 'json'
    24  or a Go template.
    25  Valid placeholders for the Go template are listed below:
    26  
    27  | **Placeholder**   | **Description**                                                               |
    28  | ----------------- | ----------------------------------------------------------------------------- |
    29  | .ID               | Pod   ID                                                                      |
    30  | .Name             | Pod   name                                                                    |
    31  | .State            | Pod   state                                                                   |
    32  | .Hostname         | Pod   hostname                                                                |
    33  | .Labels           | Pod   labels                                                                  |
    34  | .Created          | Time when the pod was created                                                 |
    35  | .CreateCgroup     | Whether cgroup was created                                                    |
    36  | .CgroupParent     | Pod   cgroup parent                                                           |
    37  | .CgroupPath       | Pod   cgroup path                                                             |
    38  | .CreateInfra      | Whether infrastructure created                                                |
    39  | .InfraContainerID | Pod   infrastructure ID                                                       |
    40  | .SharedNamespaces | Pod   shared namespaces                                                       |
    41  | .NumContainers    | Number of containers in the pod                                               |
    42  | .Containers       | Pod   containers                                                              |
    43  
    44  ## EXAMPLE
    45  ```
    46  # podman pod inspect foobar
    47  {
    48  
    49       "Id": "3513ca70583dd7ef2bac83331350f6b6c47d7b4e526c908e49d89ebf720e4693",
    50       "Name": "foobar",
    51       "Labels": {},
    52       "CgroupParent": "/libpod_parent",
    53       "CreateCgroup": true,
    54       "Created": "2018-08-08T11:15:18.823115347-05:00"
    55       "State": "created",
    56       "Hostname": "",
    57       "SharedNamespaces": [
    58            "uts",
    59            "ipc",
    60            "net"
    61       ]
    62       "CreateInfra": false,
    63       "InfraContainerID": "1020dd70583dd7ff2bac83331350f6b6e007de0d026c908e49d89ebf891d4699"
    64       "CgroupPath": ""
    65       "Containers": [
    66            {
    67                 "id": "d53f8bf1e9730281264aac6e6586e327429f62c704abea4b6afb5d8a2b2c9f2c",
    68                 "state": "configured"
    69            }
    70       ]
    71  }
    72  ```
    73  
    74  ## SEE ALSO
    75  podman-pod(1), podman-pod-ps(1)
    76  
    77  ## HISTORY
    78  August 2018, Originally compiled by Brent Baude <bbaude@redhat.com>