حذف کانتنیر

دستور remove برای حذف تعریف کانتینر استفاده می‌شود. این دستور کانتینر را از سامانه پاک می‌کند و می‌تواند در صورت نیاز فایل‌سیستم و ولوم‌های مرتبط را نیز حذف کند. اگر کانتینر در حال اجرا باشد، می‌توانید با استفاده از گزینه force آن را اجباری حذف کنید. همچنین درصورتی که میخواهید چند کانتینر را با هم حذف کنید میتوانید با regex آن ها را حذف کنید.

---

🧩 دستور کلی

{{baseURL}}/containers/{{containerId}}

---

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

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

---

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

نام پارامتر	نوع	توضیح
force	boolean	اگر کانتینر در حال اجرا باشد نیز آن را متوقف می‌کند
deleteFileSystem	boolean	فایل‌سیستم کانتینر را نیز حذف می‌کند
volumeDelete	boolean	والیوم‌های مرتبط را نیز حذف می‌کند (در حال توسعه)

---

بدنه (body)

---

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

DELETE {{baseURL}}/containers/{{containerId}}?force=true&deleteFileSystem=true

{
    "meta": {
        "shamsiDate": "14040513174649696",
        "requestId": "bd7c38e2-986a-4e22-9eb4-35076d6a65da"
    },
    "data": "2c0966ae-6aac-4334-94c3-58f0f4bfb92e"
}

{
    "meta": {
        "shamsiDate": "14040513174702636",
        "requestId": "e030fc11-6a5f-43a9-a128-388896e6e3aa"
    },
    "data": {
        "status": "done",
        "result": "Using debug verbosity\nLoading container from config file: /run/crun/cont4/config.json\nOpening hooks output\n"
    }
}

---

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

کد	معنی
200 OK	درخواست با موفقیت انجام شد

---

نکات مهم

• پیش‌فرض:

فایل‌سیستم کانتینر حذف می‌شود.

ولوم‌ها حفظ می‌شوند مگر اینکه گزینه volume فعال شود.(در حال توسعه)

اگر کانتینر در حال اجرا باشد، باید از گزینه force استفاده کنید.

اگر می‌خواهید فقط تعریف کانتینر را بدون حذف فایل‌سیستم آن پاک کنید، گزینه deleteFileSystem false را اضافه کنید.

---

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

خطا	توضیح
containerNotFound	زمانی که کانتینر وجود نداشته باشد

---

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

---