podman-pod-inspect(1) General Commands Manual podman-pod-inspect(1)

podman-pod-inspect - نمایش اطلاعات توصیف‌کننده یک پاد

podman pod inspect [گزینه‌ها] پاد ...

اطلاعات پیکربندی و وضعیت یک پاد مشخص‌شده را نمایش می‌دهد. همچنین اطلاعات کانتینرهای متعلق به آن پاد را نمایش می‌دهد.

تغییر قالب خروجی پیش‌فرض. این مقدار می‌تواند یک نوع پشتیبانی‌شده مانند 'json' یا یک الگوی Go باشد. متغیرهای جایگزین معتبر برای الگوی Go در جدول زیر آمده است:

متغیر جایگزین توضیحات
.BlkioDeviceReadBps خواندن از دستگاه ورودی/خروجی بلوکی (بایت بر ثانیه)
.BlkioDeviceWriteBps نوشتن روی دستگاه ورودی/خروجی بلوکی (بایت بر ثانیه)
.BlkioWeight وزن ورودی/خروجی بلوکی
.BlkioWeightDevice وزن دستگاه ورودی/خروجی بلوکی
.CgroupParent cgroup والد پاد
.CgroupPath مسیر cgroup پاد
.Containers کانتینرهای پاد
.CPUPeriod دوره تناوب پردازنده (CPU period)
.CPUQuota سهمیه پردازنده (CPU quota)
.CPUSetCPUs پردازنده‌های مجاز (CPUSet CPUs)
.CPUSetMems گره‌های حافظه مجاز (CPUSet Mems)
.CPUShares سهم‌های پردازنده (CPU Shares)
.CreateCgroup ایجاد شدن یا نشدن cgroup
.CreateCommand دستور ایجاد
.Created ... زمان ایجاد پاد
.CreateInfra ایجاد شدن یا نشدن کانتینر زیرساخت
.Devices دستگاه‌ها
.ExitPolicy خط‌مشی خروج
.Hostname نام میزبان پاد
.ID شناسه پاد
.InfraConfig ... پیکربندی زیرساخت (شامل فیلدهای تکمیلی)
.InfraContainerID شناسه کانتینر زیرساخت پاد
.InspectPodData ... ساختار تودرتو، فقط برای کاربران متخصص
.Labels ... برچسب‌های پاد
.LockNumber شماره قفل Libpod پاد
.MemoryLimit محدودیت حافظه، بایت
.MemorySwap محدودیت فضای مبادله (Swap)، به بایت
.Mounts نقاط اتصال
.Name نام پاد
.Namespace فضای نام
.NumContainers تعداد کانتینرهای درون پاد
.RestartPolicy خط‌مشی راه‌اندازی مجدد پاد
.SecurityOpts گزینه‌های امنیتی
.SharedNamespaces فضاهای نام اشتراکی پاد
.State وضعیت پاد
.VolumesFrom حجم‌ها از (Volumes from)

به جای ارائه نام یا شناسه پاد، از آخرین پاد ایجادشده استفاده می‌کند. نکته: آخرین پاد شروع‌شده می‌تواند مربوط به سایر کاربران پادمن روی ماشین میزبان باشد. (این گزینه در کلاینت ریموت پادمن، از جمله ماشین‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست)

بررسی پاد مشخص‌شده:

$ 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": "1020dd70583dd7ff2bac83331350f6b6e007de0d026c908e49d89eb891d4699"
         "CgroupPath": ""
         "Containers": [
              {
                   "id": "d53f8bf1e9730281264aac6e6586e327429f62c704abea4b6afb5d8a2b2c9f2c",
                   "state": "configured"
              }
         ]
     }
]

تنها نمایش نام و وضعیت پاد:

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

نمایش شناسه پاد و تعداد کانتینرها:

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

نمایش زمان ایجاد پاد و فضاهای نام مشترک:

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

نمایش محدودیت‌های منابع پاد:

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

نمایش شناسه‌های کانتینرهای درون پاد:

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

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

اوت ۲۰۱۸، در ابتدا توسط برنت بائود (Brent Baude) گردآوری شد bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩