Bucket Object Exists

bucket-object-exists · 409

ملف يفترض أن يكون جديدا يسمي key فيه ملف أصلا، فلم تكتب الـ API فوقه.

كل الصفحات

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

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

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

  • كتب رفع آخر، أو التطبيق نفسه، الـ key نفسه بين فحص التعارض وهذا الرفع.
  • رفع الملف نفسه مرتين في الوقت نفسه.

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

  • اسأل المستخدم إن كان يريد استبدال الملف الموجود، واعرض sizeBytes و lastModified.
  • ولكي تستبدله، وقع الرفع من جديد، أو أكمل الرفع على أجزاء، مع expectNew بقيمة false.
  • ولكي تبقيه، تخط الملف، وألغ الرفع على أجزاء عبر .../uploads/abort.

مثال على الرد

json
{
  "type": "bucket-object-exists",
  "title": "Bucket Object Exists",
  "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' already holds 'uploads/report.pdf'",
  "code": "BUCKET_OBJECT_EXISTS",
  "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "key": "uploads/report.pdf",
  "sizeBytes": 482113,
  "lastModified": "2026-07-28T09:12:44.000Z",
  "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-object-exists"
}