Bucket Upload Invalid

bucket-upload-invalid · 400

الرفع يسمي key أو جزءا لا تقبله الدفعة، فلم توقع الـ API شيئا.

كل الصفحات

هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. والـ reason يبين أيها: outside-prefix أو folder-key أو part-out-of-range. وكل واحد منها خطأ في الكود الذي ينادي، وليس حالة في المخزن.

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

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

  • outside-prefix: الـ key ليس تحت المجلد الذي فتحت الدفعة له.
  • folder-key: الـ key ينتهي بـ /، وهذا يسمي مجلدا وليس ملفا.
  • part-out-of-range: رقم الجزء بعد آخر جزء في الملف، حسب الحجم الذي أرسل عند توقيع الملف.

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

  • ارفع key تحت مجلد الدفعة، أو افتح دفعة للمجلد الذي فيه الـ key.
  • أزل keys المجلدات: المجلد يبقى موجودا ما دام فيه ملفات.
  • احسب عدد الأجزاء من حجم الملف، كل جزء 16 MiB.

مثال على الرد

json
{
  "type": "bucket-upload-invalid",
  "title": "Bucket Upload Invalid",
  "detail": "Cannot upload 'images/logo.png': outside-prefix",
  "code": "BUCKET_UPLOAD_INVALID",
  "key": "images/logo.png",
  "reason": "outside-prefix",
  "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": 400,
  "docs": "https://ghaym.me/docs/errors/bucket-upload-invalid"
}