مساحات الأسماء والمفاتيح

مساحات الأسماء

مساحة الاسم هي مخزن معزول متكامل — بسجل WAL خاص بها، ومُثبِّت (persister)، ومرآة في مخزن الكائنات. الأسماء من 1 إلى 96 حرفاً من [a-z0-9_-]، لا تبدأ بـ - أو _، وتقع دائماً تحت البادئة الخاصة بحسابك. دلالات دورة الحياة صريحة:

الحالة	السلوك
لم يُكتَب إليها بعد	تُعيد القراءات `404 namespace_not_found` — الكتابات فقط هي التي تُنشئ
نشطة	جميع العمليات ضمن نطاق مفتاحك
مشغولة / لم تصبح دائمة في المرآة بعد	يعيد الحذف `409` قابل لإعادة المحاولة
محذوفة	`410 namespace_deleted`، بشكل دائم — يُلتزَم بشاهد قبر دائم مضاد للاستعادة محلياً و في المرآة قبل إزالة البيانات، لذا لا يمكن لاستعادة قديمة أن تُعيد إحياء البيانات المحذوفة

# الاطلاع دون فتح المخزن
curl -s https://db.conare.ai/v1/namespaces/acme-docs/metadata \
  -H "Authorization: Bearer $CONAREDB_API_KEY"
# → { "name", "approx_row_count", "approx_logical_bytes", "generation", "dims", "index": {"status": "ann"} }

# حذف دائم (يتطلب صلاحية الحذف)
curl -s -X DELETE https://db.conare.ai/v1/namespaces/acme-docs \
  -H "Authorization: Bearer $DELETE_KEY"

المفاتيح

تُوفَّر رموز sk-conare-... من لوحة التحكم. لكل مفتاح:

نطاق مساحة الأسماء — أسماء محددة أو بادئات منتهية بـ *. يمكن للمفتاح فقط الوصول إلى /v1/namespaces/{name}/* حيث يتطابق الاسم مع أنماطه؛ وكل ما عدا ذلك يكون 403.
صلاحيات مستقلة — read وwrite وصلاحية delete التخريبية منح منفصلة. يتطلب حذف مساحة الاسم الفعلي دائماً delete صريحاً.
حد المعدل — دلو رموز طلبات في الثانية لكل مفتاح مع اندفاع لمدة ثانية واحدة؛ الطلبات التي تتجاوز الحد تحصل على 429 rate_limited.
الانتهاء — تُعيد المفاتيح المنتهية 401 expired_key.

تُعرَض الأسرار مرة واحدة وتُخزَّن فقط كملخصات SHA-256؛ والمقارنة في وقت التشغيل ذات زمن ثابت.

لا تمنح delete لمفتاح استيعاب يومي. استخدم بيانات اعتماد قصيرة العمر منفصلة للعمليات التخريبية، وافصل التقديم (مفتاح للقراءة فقط) عن خطوط إعادة البناء (مفتاح للكتابة).

المراقبة

نقطة النهاية	المصادقة	الغرض
`GET /health`	لا شيء	حيوية العملية
`GET /ready`	لا شيء	آمن للتقديم؛ `503` أثناء الاستنزاف أو بعد فشل مُثبِّت — وجِّه موازن التحميل الخاص بك إلى هنا
`GET /v1/namespaces/{ns}/metrics`	مفتاح ذو نطاق	عدّادات وقت التشغيل لمساحة الاسم الخاصة بك
`GET /v1/console`	مفتاح ذو نطاق	بيانات وصفية للمفتاح مقنّعة، والاستخدام، والمقاييس لمساحات الأسماء الخاصة بك فقط

يُنشَر التوفر العام — الذي يُفحَص من خمس مناطق عالمية مقابل https://db.conare.ai/ready — على conare.betteruptime.com. لا تتضمن سجلات API ومقاييسه أبداً أجسام الطلبات أو رموز Bearer.

البدء

المرجع

الأدلة

مساحات الأسماء والمفاتيح