تُعد ClickHouse Cloud API واجهة برمجة تطبيقات REST صُممت للمطورين لتسهيل إدارة
المؤسسات والخدمات على ClickHouse Cloud. وباستخدام Cloud API الخاصة بنا، يمكنك
إنشاء الخدمات وإدارتها، وإنشاء مفاتيح API، وإضافة أعضاء إلى
مؤسستك أو إزالتهم، وغير ذلك الكثير.
تعرّف على كيفية إنشاء أول مفتاح API والبدء في استخدام ClickHouse Cloud API.
نقطة نهاية Swagger (OpenAPI) وواجهة المستخدم
إذا كانت مؤسستك قد نُقلت إلى إحدى خطط التسعير الجديدة، وكنت تستخدم OpenAPI، فسيتعين عليك إزالة الحقل tier من طلب POST الخاص بإنشاء الخدمة.تمت إزالة الحقل tier من كائن الخدمة لأننا لم نعد نعتمد فئات للخدمة.
سيؤثر ذلك في الكائنات التي تُرجعها طلبات الخدمة POST وGET وPATCH. لذلك، قد يلزم تعديل أي شيفرة تستهلك واجهات برمجة التطبيقات هذه للتعامل مع هذه التغييرات. إذا كانت مؤسستك قد رُحّلت إلى إحدى خطط التسعير الجديدة، فسيتعيّن عليك استخدام موفّر Terraform من ClickHouse بالإصدار 2.0.0 أو أحدث. وهذه الترقية مطلوبة للتعامل مع التغييرات في السمة tier الخاصة بالخدمة، إذ بعد ترحيل التسعير، لم يعد الحقل tier مقبولًا ويجب إزالة أي إشارات إليه.ستتمكن الآن أيضًا من تحديد الحقل num_replicas كخاصية ضمن مورد الخدمة.
- عند plan وapply، على شكل تحذير
Beta Resource. لا يتعطل Terraform بسبب التحذيرات، لذا يستمر التنفيذ بشكل طبيعي.
- في وثائقه، عبر تنبيه ينص على “هذا المورد في beta”.
تعني Beta أن المخطط والسلوك قد يتغيران في إصدار موفّر مستقبلي. أما كل ما لا يحمل هذا الوسم فهو GA ومشمول بضمانات التوافق المعتادة.
قبل v3.25.2، كان الموفّر يميّز هذه الموارد بأنها alpha بدلًا من beta، وكان تحذير وقت plan يعرض Alpha Resource. تغيّرت الصياغة فقط — ولا تتضمن العملية أي migration للمخطط أو السلوك أو الحالة — لكن الأدوات التي تبحث في مخرجات plan عن Alpha Resource ستتوقف عن العثور على مطابقات بصمت. كما كانت الإصدارات السابقة تنشر build منفصلًا لـ alpha.
-alphaN (مثل 3.15.0-alpha3) نموذج الإصدار ذي البنية الواحدة. وتظل متاحة، لكنها لم تعد تُنتج.
عندما تصل ميزة إلى التوافر العام، يُزال وسم Beta من موردها في الإصدار التالي من الموفّر: يتوقف ظهور التحذير عند إنشاء plan، وتُزال الملاحظة من الوثائق. ولا يتغير أي شيء آخر — لا تعديلات على الإعدادات، ولا ترحيل للحالة، ولا تبديل بين الإصدارات المجمّعة.
يكون العدد الافتراضي للنسخ المتماثلة التي تُنشأ لكل خدمة هو 3 في مستويَي Scale وEnterprise، بينما يكون 1 في مستوى Basic.
وفي مستويَي Scale وEnterprise، يمكن تعديل هذا العدد بتمرير الحقل numReplicas في طلب إنشاء الخدمة.
يجب أن تكون قيمة الحقل numReplicas بين 2 و20 بالنسبة إلى الخدمة الأولى في مستودع. أما الخدمات التي تُنشأ في مستودع حالي، فيمكن أن يكون عدد النسخ المتماثلة فيها منخفضًا حتى 1.
نوصي بزيارة قناة Slack الخاصة بنا أولًا للحصول على دعم سريع. وإذا
كنت ترغب في الحصول على مساعدة إضافية أو مزيد من المعلومات حول واجهة برمجة التطبيقات وإمكاناتها،
فيرجى التواصل مع ClickHouse Support عبر https://console.clickhouse.cloud/support 
