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

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

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

🧩 دستور کلی


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

فیلدمقدار
MethodGET
Endpoint/images/{{imageName}}/json
Query Parametersخیر
Content-Typeapplication/json

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


بدنه (body)

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

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

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

روش استفاده (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زمانی که ایمیج مورد نظر وجود نداشته باشد

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