مشاهده جزئیات Volume
دستور inspect برای مشاهده جزئیات کامل یک Volume مشخص استفاده میشود. این اطلاعات شامل شناسه، نام، اندازه، زمان ساخت، نوع Volume و مسیر Mount آن میباشد.
🧩 دستور کلی
{{baseURL}}/volumes/{{volumeName}}
📥 مشخصات درخواست (Request)
| فیلد | مقدار |
|---|---|
| Method | GET |
| Endpoint | /volumes/{{volumeName}} |
| Query Parameters | خیر |
| Content-Type | application/json |
⚙️ پارامترها (params)
بدنه (body)
روش استفاده (How to Use)
GET {{baseURL}}/volumes/{{volumeName}}
{
"meta": {
"shamsiDate": "14040516152845130",
"requestId": "266b753b-de12-4043-9fa9-d74c38bf71b5"
},
"data": {
"Name": "vol5",
"Size": "50M",
"Type": "custom",
"CreatedAt": "2025-08-07T08:57:26.920Z",
"MountDirectory": "/tmp"
}
}
{
"data": {
"message": "VolumeDon'tExist: first create it"
},
"meta": {
"code": "unknown",
"sourceType": "unknown",
"sourceName": "unknown",
"version": "unknown",
"shamsiDate": "14040516153115544",
"requestId": "4fcf22ae-2664-47cf-a422-c64fa7f3a1c3"
}
}
وضعیت پاسخ (Status Codes)
| کد | معنی |
|---|---|
200 OK | درخواست با موفقیت انجام شد |
400 Bad Request | پارامترها اشتباه هستند یا ناقص |
500 Internal Server Error | خطای داخلی سرور در پردازش درخواست |
نکات مهم
| فیلد | توضیح |
|---|---|
name | نام Volume |
size | اندازه Volume (ممکن است خالی باشد) |
createdAt | تاریخ و زمان ساخت Volume |
type | نوع Volume (معمولاً custom) |
mountDirectory | مسیر Mount شده روی میزبان برای این Volume |
⚙️ خطاهای رایج
| خطا | توضیح |
|---|---|
VolumeDon'tExist | زمانی که والیوم وجود نداشته باشد |