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

کپی فایل بین میزبان و کانتینر

دستور copy برای کپی‌کردن فایل‌ها و دایرکتوری‌ها بین سیستم میزبان و کانتینر استفاده می‌شود. عملکرد این دستور مشابه دستور cp در لینوکس است.

🧩 دستور کلی​

{{baseURL}}/containers/copy

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

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

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

بدنه (body)​

{
    "src":"/tmp/test",
    "dist":"cont1:/var"
}

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

POST {{baseURL}}/containers/copy

{
    "src":"/tmp/test",
    "dist":"cont1:/var"
}
{
    "meta": {
        "shamsiDate": "14040513105532981",
        "requestId": "d167a6be-0f4d-44ea-9cef-7d920bd9afb4"
    },
    "data": "fb9ecd31-8f3e-46d9-b385-2784e6a2f0b1"
}

هش آیدی مربوط به آن داده می‌شود تا اتصال بسته شود و کاربر می‌تواند با وارد کردن این آیدی در ای‌پی‌آی jobStatus، خروجی را مشاهده کند.

GET {{baseURL}}/containers/jobs/133f287e-55f2-44a8-bb37-170b16762d62
{
    "meta": {
        "shamsiDate": "14040513105550988",
        "requestId": "dbf7f5ad-b467-4d90-b133-e6ea753cb9a3"
    },
    "data": {
        "status": "done",
        "result": "Copied from /tmp/test to /var/lib/k3/overlays/b25d456990e26aff/rootfs/var"
    }
}

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

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

نکات مهم​

هنگام مشخص کردن مسیر کانتینر، حتماً از فرمت containerId:path استفاده کنید.

اگر مسیر مقصد وجود نداشته باشد، به صورت خودکار ایجاد می‌شود. (در حال توسعه)

ساختار دستور بسیار شبیه به docker cp است و یادگیری آن بسیار سریع می‌باشد.

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

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