پرش به مطلب اصلی

توقف کانتنیر

دستور stop برای متوقف کردن یک کانتینر استفاده می‌شود. این دستور به کانتینر فرصت می‌دهد که به شکل صحیح خاموش شود و در صورت ناتوانی در این کار، پس از مدت زمان مشخص شده، کانتینر را به اجبار متوقف می‌کند.

🧩 دستور کلی​

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

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

فیلدمقدار
MethodPOST
Endpoint/containers/{{containerId}}/stop
Query Parametersخیر
Content-Typeapplication/json

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

بدنه (body)​

{}

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

POST {{baseURL}}/containers/{{containerId}}/stop
{
    "data": {
        "message": "containerNotFound: No container exists with the specified name or ID prefix.",
        "containerId": "cont1"
    },
    "meta": {
        "code": "unknown",
        "sourceType": "unknown",
        "sourceName": "unknown",
        "version": "unknown",
        "shamsiDate": "14040513113524892",
        "requestId": "a359f88c-44fb-40d6-a963-4527a6c09463"
    }
}
{
    "meta": {
        "shamsiDate": "14040513113805854",
        "requestId": "8826d32f-c541-4c1b-94e4-7bf318b15564"
    },
    "data": "Using debug verbosity\n"
}

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

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

نکات مهم​

در این دستور به کانتینر sigterm ارسال میشود.

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

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

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