github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/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  
    15  #### **--format**=*format*, **-f**
    16  
    17  Change the default output format.  This can be of a supported type like 'json'
    18  or a Go template.
    19  Valid placeholders for the Go template are listed below:
    20  
    21  | **Placeholder**   | **Description**                                                               |
    22  | ----------------- | ----------------------------------------------------------------------------- |
    23  | .ID               | Pod   ID                                                                      |
    24  | .Name             | Pod   name                                                                    |
    25  | .State            | Pod   state                                                                   |
    26  | .Hostname         | Pod   hostname                                                                |
    27  | .Labels           | Pod   labels                                                                  |
    28  | .Created          | Time when the pod was created                                                 |
    29  | .CreateCgroup     | Whether cgroup was created                                                    |
    30  | .CgroupParent     | Pod   cgroup parent                                                           |
    31  | .CgroupPath       | Pod   cgroup path                                                             |
    32  | .CreateInfra      | Whether infrastructure created                                                |
    33  | .InfraContainerID | Pod   infrastructure ID                                                       |
    34  | .SharedNamespaces | Pod   shared namespaces                                                       |
    35  | .NumContainers    | Number of containers in the pod                                               |
    36  | .Containers       | Pod   containers                                                              |
    37  
    38  #### **--latest**, **-l**
    39  
    40  Instead of providing the pod name or ID, use the last created pod. If you use methods other than Podman
    41  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, including Mac and Windows (excluding WSL2) machines)
    42  
    43  ## EXAMPLE
    44  ```
    45  # podman pod inspect foobar
    46  {
    47  
    48       "Id": "3513ca70583dd7ef2bac83331350f6b6c47d7b4e526c908e49d89ebf720e4693",
    49       "Name": "foobar",
    50       "Labels": {},
    51       "CgroupParent": "/libpod_parent",
    52       "CreateCgroup": true,
    53       "Created": "2018-08-08T11:15:18.823115347-05:00"
    54       "State": "created",
    55       "Hostname": "",
    56       "SharedNamespaces": [
    57            "uts",
    58            "ipc",
    59            "net"
    60       ]
    61       "CreateInfra": false,
    62       "InfraContainerID": "1020dd70583dd7ff2bac83331350f6b6e007de0d026c908e49d89ebf891d4699"
    63       "CgroupPath": ""
    64       "Containers": [
    65            {
    66                 "id": "d53f8bf1e9730281264aac6e6586e327429f62c704abea4b6afb5d8a2b2c9f2c",
    67                 "state": "configured"
    68            }
    69       ]
    70  }
    71  ```
    72  
    73  ## SEE ALSO
    74  **[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**, **[podman-inspect(1)](podman-inspect.1.md)**
    75  
    76  ## HISTORY
    77  August 2018, Originally compiled by Brent Baude <bbaude@redhat.com>