名称

podman-pod-inspect - 显示有关 Pod 的信息

简介

podman pod inspect [选项] pod …

描述

显示给定 Pod 的配置和状态信息。它还显示属于该 Pod 的容器信息。

选项

--format, -f=format

更改默认输出格式。这可以是受支持的类型，如“json”，也可以是 Go 模板。Go 模板的有效占位符如下所示

占位符	描述
.BlkioDeviceReadBps	块 I/O 设备读取，以字节/秒为单位
.BlkioDeviceWriteBps	块 I/O 设备读取，以字节/秒为单位
.BlkioWeight	块 I/O 权重
.BlkioWeightDevice	块 I/O 设备权重
.CgroupParent	Pod 的 cgroup 父级
.CgroupPath	Pod 的 cgroup 路径
.Containers	Pod 容器
.CPUPeriod	CPU 周期
.CPUQuota	CPU 配额
.CPUSetCPUs	CPU 集 CPUs
.CPUSetMems	CPU 集 Mems
.CPUShares	CPU 份额
.CreateCgroup	是否创建 cgroup
.CreateCommand	创建命令
.Created …	Pod 创建时间
.CreateInfra	是否创建了基础设施
.Devices	设备
.ExitPolicy	退出策略
.Hostname	Pod 主机名
.ID	Pod ID
.InfraConfig …	基础设施配置（包含更多字段）
.InfraContainerID	Pod 基础设施 ID
.InspectPodData …	嵌套结构，仅限专家
.Labels …	Pod 标签
.LockNumber	Pod 的 Libpod 锁编号
.MemoryLimit	内存限制，字节
.MemorySwap	内存交换限制，以字节为单位
.Mounts	挂载
.Name	Pod 名称
.Namespace	命名空间
.NumContainers	Pod 中的容器数量
.RestartPolicy	Pod 的重启策略
.SecurityOpts	安全选项
.SharedNamespaces	Pod 共享命名空间
.State	Pod 状态
.VolumesFrom	来自卷

--latest, -l

不提供名称或 ID，而是使用最新创建的容器。注意：最新创建的容器可能来自主机上 Podman 的其他用户。（此选项不适用于远程 Podman 客户端，包括 Mac 和 Windows（WSL2 除外）机器）

示例

检查指定的 pod

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

仅显示 pod 名称和状态

$ podman pod inspect --format "{{.Name}}\t{{.State}}" mypod
mypod	Running

显示 pod ID 和容器数量

$ podman pod inspect mypod --format "Pod {{.Name}} ({{.ID}}) has {{.NumContainers}} containers"
Pod mypod (605f5f776e101a6e0ad11ea802cae25eabf299da77122f2963fa65dc6ccf6717) has 2 containers

显示 pod 创建时间和共享命名空间

$ podman pod inspect mypod --format "Created: {{.Created}}\nShared: {{.SharedNamespaces}}"
Created: 2025-08-14 21:16:05.861363099 +0000 UTC
Shared: [net uts ipc]

显示 pod 资源限制

$ podman pod inspect --format "Memory: {{.MemoryLimit}}, CPU Period: {{.CPUPeriod}}, CPU Quota: {{.CPUQuota}}" mypod
Memory: 1073741824, CPU Period: 100000, CPU Quota: 50000

显示 pod 中的容器 ID

$ podman pod inspect --format "{{range .Containers}}{{.Id}}: {{.State}} {{end}}" mypod
e907f7902decca9d6b600b4d3cca9541d9b89dd726b2af7ad2eba05d2a97083f: running c5a53050a31aed71c55cb6a31b9564c69a1009f77750f3f0e8093bd98fcd8918: running

另请参阅

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

历史

2018 年 8 月，最初由 Brent Baude bbaude@redhat.com 编译