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

ساخت حجم جدید

دستور create برای ساخت یک Volume جدید در سیستم استفاده می‌شود. این Volume می‌تواند برای ذخیره‌سازی داده‌های پایدار در کانتینرها مورد استفاده قرار گیرد.

🧩 دستور کلی​

{{baseURL}}/volumes/create

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

فیلدمقدار
MethodPOST
Endpoint/volumes/create
Query Parametersخیر
Content-Typeapplication/json

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

بدنه (body)​

گزینه بلندتوضیح
--sizeتعیین اندازه حجم (مثل 10GB, 500MB)
--typeنوع Volume (LVM ,cusotm)
--mountمسیر mount حجم روی میزبان
--helpنمایش راهنمای کامل دستور

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

POST {{baseURL}}/volumes/create
{
    "volumeName":"vol6",
    "size":"50M",
    "type":"custom",
    "mount":"/tmp"
}
{
    "data": {
        "message": "VolumeAlreadyExist: change name for create it"
    },
    "meta": {
        "code": "unknown",
        "sourceType": "unknown",
        "sourceName": "unknown",
        "version": "unknown",
        "shamsiDate": "14040516150251992",
        "requestId": "da8a80cc-ccd7-42fd-8e8f-f19eec403d4c"
    }
}
{
    "meta": {
        "shamsiDate": "14040516151246551",
        "requestId": "71549220-f505-41ce-bf2c-25962237a139"
    },
    "data": {
        "Name": "voll",
        "Size": "50M",
        "Type": "custom",
        "CreatedAt": "2025-08-07T11:42:46.540Z",
        "MountDirectory": "/tmp"
    }
}

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

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

نکات مهم​

اگر مسیر mount مشخص نشود، سیستم به صورت خودکار مسیر مناسبی اختصاص می‌دهد.

این دستور برای مدیریت فضای پایدار بین کانتینرها بسیار مناسب است.

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

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

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