لیست کانتینرها

دستور list برای مشاهده‌ی لیستی از کانتینرهای موجود در سامانه استفاده می‌شود. این دستور با قابلیت فیلتر پیشرفته، امکان بررسی وضعیت، زمان ساخت، شناسه، یا ایمیج کانتینرها را برای شما فراهم می‌کند.

🧩 دستور کلی

{{base_url}}/containers/json

---

📥 مشخصات درخواست (Request)

فیلد	مقدار
Method	GET
Endpoint	/containers/json
Query Parameters	بله
Content-Type	application/json

---

⚙️ پارامترها (params)

نام پارامتر	نوع	توضیح
status	string	وضعیت کانتینر (مثل: running, paused, stopped, created )
id	string	شناسه یا نام کانتینر خاص
image	string	فیلتر بر اساس ایمیج (مثلاً: ubuntu:latest) (درحال توسعه)
created	string (YYYY-MM-DD)	فقط کانتینرهایی که در این تاریخ ساخته شده‌اند
all	boolean	اگر true باشد، تمام کانتینرها (شامل متوقف‌شده‌ها) را برمی‌گرداند

---

بدنه (body)

---

روش استفاده (How to Use)

GET {{base_url}}/containers/json?status=paused&id=cont1&image=ubuntu:latest&created=2025-07-02&all=true

{
    "meta": {
        "shamsiDate": "14040511125546345",
        "requestId": "6d947e0c-0225-44e9-970b-57679721235d"
    },
    "data": [
        {
            "id": "10f069e4",
            "pid": 3742,
            "status": "running",
            "created": "2025-08-02T08:18:15.264Z",
            "owner": "root",
            "name": "cont"
        }
    ]
}

---

وضعیت‌ پاسخ (Status Codes)

کد	معنی
200 OK	درخواست با موفقیت انجام شد
400 Bad Request	پارامترها اشتباه هستند یا ناقص
500 Internal Server Error	خطای داخلی سرور در پردازش درخواست

---

نکات مهم

• استفاده از all به‌طور همزمان با گزینه‌هایی مانند status, image, created یا containerId مجاز نیست.

⚙️ خطاهای رایج

خطا	توضیح
Error: all cannot be used with status, created, or image	پارامترهای متداخل با هم استفاده شده
Unknown status	مقدار status یکی از وضعیت‌های معتبر نیست
Date format error	created باید با فرمت YYYY-MM-DD باشد

---

🆘 دریافت راهنما

---