توقف کانتینرها

دستور kill برای ارسال سیگنال‌های POSIX به یک کانتینر استفاده می‌شود. به‌صورت پیش‌فرض سیگنال SIGKILL (9) ارسال می‌شود که باعث توقف فوری کانتینر می‌شود. همچنین می‌توانید فقط پردازش‌های داخل کانتینر را بدون متوقف‌کردن خود کانتینر خاتمه دهید.

---

🧩 دستور کلی

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

---

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

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

---

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

نام پارامتر	نوع	توضیح
signal	number	سیگنال ارسالی به کانتینر چه عددی باشد

| all | boolean | تمام پراسس های داخل کانتینر غیر از پراسس اصلی را کیل میکند|

---

بدنه (body)

{}

---

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

POST {{baseURL}}/containers/{{containerId}}/kill?signal=9

{
    "data": {
        "message": "container not running: No such process",
        "containerId": "cont4"
    },
    "meta": {
        "code": "unknown",
        "sourceType": "unknown",
        "sourceName": "unknown",
        "version": "unknown",
        "shamsiDate": "14040513115204089",
        "requestId": "f2f2867b-1a34-47ec-ab3f-9dc91c63b762"
    }
}

---

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

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

---

نکات مهم

اگر سیگنال مشخص نکنید، سیگنال پیش‌فرض SIGKILL (شماره 9) ارسال می‌شود.

اگر از گزینه all استفاده کنید، فقط پردازش‌های داخل کانتینر متوقف می‌شوند و خود کانتینر فعال باقی می‌ماند.

---

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

خطا	توضیح
containerNotFound	زمانی که کانتینر وجود نداشته باشد
containerNotInRunningState	زمانی که وضعیت کانتینر در حالت اجرا (Running) نباشد

---

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

---