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

دریافت لیست ایمیج‌ها

این API لیستی از ایمیج‌های موجود در سیستم را برمی‌گرداند.

🧩 دستور کلی​

{{base_url}}/images/list

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

فیلدمقدار
MethodGET
Endpoint/images/list
Query Parametersبله
Content-Typeapplication/json

📌 Query Params​

پارامترمقدار نمونهتوضیح
imagenginxنام ایمیج
taglatestتگ ایمیج

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

GET http://localhost:4001/images/list?image=nginx&tag=latest

پاسخ نمونه (Sample Response)​

{
    "meta": {
        "shamsiDate": "14040518135210144",
        "requestId": "c88d4545-8d08-4564-935c-9240bd1367e0"
    },
    "data": [
        {
            "Name": "python",
            "Tag": "alpine",
            "Size": "15 MB"
        },
        {
            "Name": "python",
            "Tag": "v1",
            "Size": "42 MB"
        }
    ]
}

توضیح فیلدهای خروجی​

فیلدنوع دادهتوضیح
Namestringنام ایمیج
Tagstringتگ مربوط به ایمیج
Sizestringاندازه ایمیج

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

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

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

خطاتوضیح
permissionDeniedزمانی که کاربر مجوز دسترسی به لیست ندارد

🆘 یادداشت‌ها​

  • اطمینان حاصل کنید که مجوزهای لازم برای مشاهده لیست ایمیج‌ها را دارید.
  • پاسخ ممکن است بر اساس موجود بودن ایمیج‌ها در سیستم تغییر کند.