Bucket Upload Batch Closed

bucket-upload-batch-closed · 409

انتهت دفعة الرفع، فلن توقع الـ API أي شيء آخر تحتها.

كل الصفحات

هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. والدفعة تجمع ملفات رفعة واحدة. وحالة الدفعة تظهر في detail فقط: الـ API تكتب رمز الـ HTTP في status فوقها.

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

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

  • أكملت الدفعة أصلا، من هذا العميل أو من tab آخر.
  • انتهى آخر رابط موقع فيها والدفعة ما زالت مفتوحة، فأغلقها التنظيف الدوري.
  • نداء آخر يكمل الدفعة الآن: والـ detail يقول عندها closing.

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

  • ابدأ دفعة جديدة عبر POST /v1/buckets/<id>/upload-batches، ووقع الملفات المتبقية تحتها.
  • ما وصل حفظ وسجل: اعرض المجلد قبل أن ترفع ملفا مرة أخرى.

مثال على الرد

json
{
  "type": "bucket-upload-batch-closed",
  "title": "Bucket Upload Batch Closed",
  "detail": "Upload batch '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' is expired; start a new one",
  "code": "BUCKET_UPLOAD_BATCH_CLOSED",
  "batchId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402",
  "status": 409,
  "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",
  "docs": "https://ghaym.me/docs/errors/bucket-upload-batch-closed"
}