دریافت اطلاعات یک ایمیج

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

🧩 دستور کلی

{{baseURL}}/images/{{imageName}}/json

---

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

فیلد	مقدار
Method	GET
Endpoint	/images/{{imageName}}/json
Query Parameters	خیر
Content-Type	application/json

---

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

---

بدنه (body)

{
	"containerImageTransport": "oci",
    "imageTag": "{{tagName}}"
}

---

فیلدهای ورودی (Options)

فیلد	نوع داده	توضیح
containerImageTransport	string	درگاهی که از ان میخواهید طلاعات ایمیج را بگیرید (oci, docker, dir, ...)
imageTag	string	تگی که میخواهید اطلاعات ان را بدست اورید

---

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

POST http://localhost:4001/images/python/json

{
	"containerImageTransport": "oci",
    "imageTag": "latest"
}

پاسخ به صورت یک ابجکت است

{
    "meta": {
        "shamsiDate": "14040518152316330",
        "requestId": "8da91172-6bb5-4c7d-bc74-bf1babd9f369"
    },
    "data": {
        "Digest": "sha256:eac4a16ddcd4b8b9568ffacc809db6264256f1ce852b9ca4a33b29582aa2138b",
        "RepoTags": [],
        "Created": "2025-08-06T21:20:23Z",
        "DockerVersion": "",
        "Labels": null,
        "Architecture": "amd64",
        "Os": "linux",
        "Layers": [
            "sha256:9824c27679d3b27c5e1cb00a73adb6f4f8d556994111c12db3c5d61a0c843df8",
            "sha256:92c4eebaa272cc17817e910d0a265251d5c7939c2a7fd589b9e33862b5d2883b",
            "sha256:cd1ee59cc7f921e0f0653215afd23f249781d585b09815848d963ab669637f65",
            "sha256:b2a67b5a8495beb1ecd539189b2a9bed1221033c3def1615cdfdf916f2148c2e"
        ],
        "LayersData": [
            {
                "MIMEType": "application/vnd.oci.image.layer.v1.tar+gzip",
                "Digest": "sha256:9824c27679d3b27c5e1cb00a73adb6f4f8d556994111c12db3c5d61a0c843df8",
                "Size": 3799689,
                "Annotations": null
            },
            {
                "MIMEType": "application/vnd.oci.image.layer.v1.tar+gzip",
                "Digest": "sha256:92c4eebaa272cc17817e910d0a265251d5c7939c2a7fd589b9e33862b5d2883b",
                "Size": 447743,
                "Annotations": null
            },
            {
                "MIMEType": "application/vnd.oci.image.layer.v1.tar+gzip",
                "Digest": "sha256:cd1ee59cc7f921e0f0653215afd23f249781d585b09815848d963ab669637f65",
                "Size": 12380211,
                "Annotations": null
            },
            {
                "MIMEType": "application/vnd.oci.image.layer.v1.tar+gzip",
                "Digest": "sha256:b2a67b5a8495beb1ecd539189b2a9bed1221033c3def1615cdfdf916f2148c2e",
                "Size": 249,
                "Annotations": null
            }
        ],
        "Env": [
            "PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
            "GPG_KEY=7169605F62C751356D054A26A821E680E5FA6305",
            "PYTHON_VERSION=3.13.6",
            "PYTHON_SHA256=17ba5508819d8736a14fbfc47d36e184946a877851b2e9c4b6c43acb44a3b104"
        ]
    }
}

---

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

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

---

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

خطا	توضیح
no such image	زمانی که ایمیج مورد نظر وجود نداشته باشد

---

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

---