Bucket Upload Incomplete

bucket-upload-incomplete · 409

المخزن لا يحتوي كل أجزاء الملف بحجمها الكامل، فلم تجمعها الـ API.

كل الصفحات

هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. الأجزاء تقرأ من المخزن، وليس من النداء أبدا. والـ missingPartNumbers يعدد الأجزاء الناقصة أو القصيرة، والرفع يبقى مفتوحا لها.

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

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

  • فشل رفع جزء أو انقطع، مثلا عندما ينقطع الاتصال.
  • أكمل الرفع قبل أن تنتهي كل الأجزاء.

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

  • وقع الأجزاء التي في missingPartNumbers من جديد عبر .../uploads/parts، وأرسلها، ثم أكمل مرة أخرى.
  • لا تكمل مرة أخرى قبل أن ترسل هذه الأجزاء: سيكون الجواب نفسه.

مثال على الرد

json
{
  "type": "bucket-upload-incomplete",
  "title": "Bucket Upload Incomplete",
  "detail": "'videos/launch.mp4' is missing 2 part(s)",
  "code": "BUCKET_UPLOAD_INCOMPLETE",
  "key": "videos/launch.mp4",
  "missingPartNumbers": [
    3,
    7
  ],
  "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/complete",
  "method": "POST",
  "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads/complete",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/bucket-upload-incomplete"
}