Bucket Object Too Large

bucket-object-too-large · 400

الملف أكبر من الـ 5 GiB التي تقبلها مسارات الرفع، فلم توقع الـ API له شيئا.

كل الصفحات

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

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

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

  • الملف أكبر من 5 GiB، مثل صورة قرص أو أرشيف كبير.
  • أرسل النداء sizeBytes خطأ، مثل حجم بوحدة أخرى.

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

  • قسم الملف إلى قطع أصغر من 5 GiB، أو اضغطه، ثم ارفع كل قطعة.
  • تأكد أن sizeBytes هو حجم الملف بالـ bytes.

مثال على الرد

json
{
  "type": "bucket-object-too-large",
  "title": "Bucket Object Too Large",
  "detail": "'backups/site.tar' is 6442450944 bytes; the most per file is 5368709120",
  "code": "BUCKET_OBJECT_TOO_LARGE",
  "key": "backups/site.tar",
  "sizeBytes": 6442450944,
  "maxBytes": 5368709120,
  "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-object-too-large"
}