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"
}