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

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

مساحة الأسماء مخزن كامل معزول — بـ WAL خاصة به وموصل استدامة ومرآة لتخزين الكائنات. الأسماء 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"

المفاتيح

تُزوَّد رموز cdb_... من وحدة التحكم. لكل مفتاح:

نطاق مساحة الأسماء — أسماء دقيقة أو بادئات مذيّلة بـ *. يمكن للمفتاح فقط الوصول إلى /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.

البدء

المرجع

الأدلة

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