Bucket Key Missing

bucket-key-missing · 409

ليس للمخزن مفتاح يعرض أو يوقع به، فلم تستطع الـ API الوصول إلى ملفاته.

كل الصفحات

لا يوجد ما يعيق المخزن: إصدار مفتاح جديد له بعد عودة الحساب فشل في المنتصف. وتغيير مفاتيحه يصدر مفتاحا ويحل هذا الأمر.

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

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

  • علق الحساب ثم عاد، وفشل إصدار مفتاح جديد للمخزن في المنتصف.

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

  • غير مفاتيح المخزن عبر POST /v1/buckets/<id>/credentials/rotate، ثم أعد المحاولة.
  • الخدمة المربوطة بالمخزن تقرأ المفتاح الجديد من الـ deploy التالي لها، فأجر لها redeploy.

مثال على الرد

json
{
  "type": "bucket-key-missing",
  "title": "Bucket Key Missing",
  "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' has no key; rotate its credentials to issue one",
  "code": "BUCKET_KEY_MISSING",
  "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/objects",
  "method": "GET",
  "instance": "GET /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/objects",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/bucket-key-missing"
}