| podman-volume-ls(1) | General Commands Manual | podman-volume-ls(1) |
نام (NAME)
podman-volume-ls - فهرست کردن تمامی حجم‌های موجود
خلاصه دستور (SYNOPSIS)
podman volume ls [گزینه‌ها]
توضیحات (DESCRIPTION)
فهرست کردن تمام حجم‌های موجود در سیستم. خروجی می‌تواند با استفاده از پرچم --filter فیلتر شود و با پرچم --format به صورت JSON یا با الگوی Go قالب‌بندی گردد. از پرچم --quiet برای چاپ فقط نام حجم‌ها استفاده کنید.
گزینه‌ها (OPTIONS)
--filter, -f=filter
فیلتر کردن حجم‌هایی که در خروجی نمایش داده می‌شوند.
اگر بیش از یک فیلتر وجود دارد، گزینه --filter باید چندین بار ارسال شود: --filter name=test --filter driver=local.
فیلترهایی با کلید یکسان به صورت فراگیر (یا) عمل می‌کنند، به جز label که مانعةالجمع (و) است. فیلترها با کلیدهای متفاوت همیشه به صورت اشتراکی عمل می‌کنند.
حجم‌ها را می‌توان بر اساس ویژگی‌های زیر فیلتر کرد:
| فیلتر (Filter) | توضیحات (Description) |
| anonymous | [بولین] تطبیق با حجم‌های ناشناس (true) یا حجم‌های نام‌گذاری‌شده (false) |
| dangling | [معلق] تطبیق با تمامی حجم‌هایی که توسط هیچ کانتینری ارجاع داده نشده‌اند |
| driver | [درایور] تطبیق با حجم‌ها بر اساس درایور آن‌ها |
| label | [کلید] یا [کلید=مقدار] برچسب اختصاص‌یافته به یک حجم |
| label! | [کلید] یا [کلید=مقدار] حجم‌های فاقد برچسب مشخص‌شده |
| name | [نام] نام حجم (از عبارت باقاعده پشتیبانی می‌کند) |
| opt | تطبیق با گزینه‌های درایور ذخیره‌سازی |
| scope | فیلتر کردن حجم‌ها بر اساس دامنه |
| after/since | فیلتر بر اساس حجم‌های ایجادشده پس از حجم مشخص‌شده (نام یا تگ) |
| until | فیلتر بر اساس حجم‌های ایجادشده پیش از برچسب زمانی مشخص |
--format=format
قالب‌بندی خروجی حجم‌ها با استفاده از الگوی Go.
متغیرهای مجاز برای الگوی Go در جدول زیر فهرست شده‌اند:
| مکان‌نما (Placeholder) | توضیحات (Description) |
| .Anonymous | مشخص می‌کند که آیا حجم ناشناس است یا خیر |
| .CreatedAt ... | زمان ایجاد حجم |
| .Driver | درایور حجم |
| .GID | شناسه گروهی (GID) حجم |
| .InspectVolumeData ... | استفاده نشود |
| .Labels ... | اطلاعات برچسب‌های مرتبط با حجم |
| .LockNumber | شماره قفل Libpod مربوط به حجم |
| .MountCount | تعداد دفعاتی که حجم متصل شده است |
| .Mountpoint | نقطه اتصال مبدا حجم |
| .Name | نام حجم |
| .NeedsChown | مشخص می‌کند آیا حجم نیاز به تغییر مالکیت (chown) دارد یا خیر |
| .NeedsCopyUp | مشخص می‌کند آیا نیاز به کپی داده‌ها به حجم وجود دارد یا خیر |
| .Options ... | گزینه‌های حجم |
| .Scope | دامنه (Scope) حجم |
| .Status ... | وضعیت حجم |
| .StorageID | شناسه StorageID حجم |
| .Timeout | زمان انتظار (Timeout) حجم |
| .UID | شناسه کاربری (UID) حجم |
| .VolumeConfigResponse ... | استفاده نشود |
--help
نمایش راهنمای استفاده و خلاصه دستور.
--noheading, -n
حذف سرستون‌های جدول از خروجی فهرست.
--quiet, -q
چاپ خروجی در حالت خاموش؛ فقط نام حجم‌ها نمایش داده می‌شود.
مثال‌ها (EXAMPLES)
فهرست کردن تمام حجم‌ها:
$ podman volume ls
فهرست کردن تمام حجم‌ها و نمایش محتوا در قالب json:
$ podman volume ls --format json
فهرست کردن تمام حجم‌ها و نمایش فیلدهای Driver و Scope آن‌ها:
$ podman volume ls --format "{{.Driver}} {{.Scope}}"
فهرست کردن حجم‌هایی با نام foo و برچسب blue:
$ podman volume ls --filter name=foo,label=blue
فهرست کردن حجم‌هایی با برچسب key=value:
$ podman volume ls --filter label=key=value
همچنین ببینید (SEE ALSO)
تاریخچه (HISTORY)
نوامبر ۲۰۱۸، نگارش اولیه توسط Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩