Bucket Folder Deleting

bucket-folder-deleting · 409

يوجد حذف مجلد جار على هذا المسار، فرفضت الـ API الكتابة فيه أو الحذف منه.

كل الصفحات

الـ prefix هو المجلد الذي يحذف. الرفع عليه، وحذفه، أو حذف ملف فيه أو مجلد يحيط به، تنتظر كلها حتى ينتهي، وباقي المخزن يعمل كالمعتاد.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع code، bucketId و prefix.

الأسباب الشائعة

  • رفع ملف إلى مجلد والمجلد قيد الحذف.
  • حذف ملف في المجلد وحذف المجلد جار.
  • بدأ حذف مجلد على المجلد نفسه، أو على مجلد داخله أو يحيط به.

كيف تصلح الطلب

  • تابع حذف المجلد عبر GET /v1/buckets/<id>/folder-deletes، وأعد المحاولة عندما ينتهي.
  • ارفع الملف إلى مجلد آخر إذا كان لا يستطيع الانتظار.

مثال على الرد

json
{
  "type": "bucket-folder-deleting",
  "title": "Bucket Folder Deleting",
  "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' is deleting 'uploads/2025/'",
  "code": "BUCKET_FOLDER_DELETING",
  "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "prefix": "uploads/2025/",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads",
  "method": "POST",
  "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/bucket-folder-deleting"
}