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)
       podman(1), podman-pod(1), podman-inspect(1)


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

                                                         podman-pod-inspect(1)