| podman-pod-inspect(1) | General Commands Manual | podman-pod-inspect(1) |
نام (NAME)
podman-pod-inspect - نمایش اطلاعات توصیفکننده یک پاد
خلاصه دستور (SYNOPSIS)
podman pod inspect [گزینهها] پاد ...
توضیحات (DESCRIPTION)
اطلاعات پیکربندی و وضعیت یک پاد مشخصشده را نمایش میدهد. همچنین اطلاعات کانتینرهای متعلق به آن پاد را نمایش میدهد.
گزینهها (OPTIONS)
--format, -f=format
تغییر قالب خروجی پیشفرض. این مقدار میتواند یک نوع پشتیبانیشده مانند '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) |
--latest, -l
به جای ارائه نام یا شناسه پاد، از آخرین پاد ایجادشده استفاده میکند. نکته: آخرین پاد شروعشده میتواند مربوط به سایر کاربران پادمن روی ماشین میزبان باشد. (این گزینه در کلاینت ریموت پادمن، از جمله ماشینهای مک و ویندوز (به استثنای WSL2) در دسترس نیست)
مثالها (EXAMPLES)
بررسی پاد مشخصشده:
$ 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
همچنین ببینید (SEE ALSO)
تاریخچه (HISTORY)
اوت ۲۰۱۸، در ابتدا توسط برنت بائود (Brent Baude) گردآوری شد bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩