Bucket Not Ready

bucket-not-ready · 409

المخزن ليس جاهزا، فليس لدى الـ API مفتاح تعطيه ولا ملفات تعرضها.

كل الصفحات

حالة المخزن تظهر في detail فقط: الـ API تكتب رمز الـ HTTP في status فوقها. اقرأ المخزن لتعرف حالته.

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

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

  • أنشئ المخزن قبل قليل وما زال pending أو provisioning.
  • فشل إنشاء المخزن، فهو failed.
  • طلبت مفاتيحه، أو طلب تغييرها، قبل أن يجهز.

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

  • اقرأ المخزن عبر GET /v1/buckets/<id> وانتظر ما دام الـ status الخاص به pending أو provisioning، ثم أعد المحاولة.
  • وإذا كان الـ status الخاص به failed، فأخبر المستخدم واذكر detail.

مثال على الرد

json
{
  "type": "bucket-not-ready",
  "title": "Bucket Not Ready",
  "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' has no credentials while it is provisioning",
  "code": "BUCKET_NOT_READY",
  "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "status": 409,
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/credentials",
  "method": "GET",
  "instance": "GET /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/credentials",
  "docs": "https://ghaym.me/docs/errors/bucket-not-ready"
}