الانتقال إلى المحتوى الرئيسي
POST
إنشاء خدمة جديدة

التفويضات

Authorization
string
header
مطلوب

استخدم معرّف المفتاح والسرّ الخاص به اللذين تم الحصول عليهما من ClickHouse Cloud console: https://clickhouse.com/docs/cloud/manage/openapi

معلمات المسار

organizationId
string<uuid>
مطلوب

معرّف المؤسسة التي ستملك الخدمة.

الجسم

application/json
backupId
string<uuid>

معرّف Backup اختياري يُستخدم كحالة أولية للخدمة الجديدة. عند استخدامه، يجب أن تكون المنطقة وtier الخاصة بالـinstance الجديدة مماثلتين لقيم الـinstance الأصلية.

byocId
string

هذا هو المعرّف الذي يتم إرجاعه بعد إعداد Region لـBring Your Own Cloud (BYOC). عند تحديد المعامل byocId، يصبح المعاملان minReplicaMemoryGb وmaxReplicaGb مطلوبين أيضًا، على أن تكون قيمهما من بين الأحجام التالية: 48 و116 و172 و232.

complianceType
enum<string>

نوع الامتثال التنظيمي للخدمة.

الخيارات المتاحة:
hipaa,
pci
dataWarehouseId
string

مستودع البيانات الذي يحتوي على هذه الخدمة

encryptionAssumedRoleIdentifier
string

Role اختياري لاستخدامه في تشفير القرص

encryptionKey
string

مفتاح اختياري يوفّره العميل لتشفير القرص

endpoints
object[]

قائمة بـendpoints الخدمة المطلوب تمكينها أو تعطيلها

hasTransparentDataEncryption
boolean

تكون القيمة true إذا كان يجب تمكين Transparent Data Encryption ‏(TDE) لهذه الخدمة. يتوفر TDE فقط لـEnterprise organization tiers ولا يمكن تمكينه إلا عند إنشاء الخدمة.

idleScaling
boolean

عند ضبطها على true، يُسمح للخدمة بأن تتوسّع نزولًا إلى الصفر عند الخمول. true هي القيمة الافتراضية.

idleTimeoutMinutes
number

اضبط الحد الأدنى لمهلة idling (بالدقائق). يجب أن تكون >= 5 دقائق.

ipAccessList
object[]

قائمة بعناوين IP المسموح لها بالوصول إلى الخدمة

isReadonly
boolean

تكون القيمة true إذا كانت هذه الخدمة للقراءة فقط. ولا يمكن أن تكون للقراءة فقط إلا إذا تم توفير dataWarehouseId.

maxReplicaMemoryGb
number

الحد الأقصى لإجمالي الذاكرة لكل replica أثناء التوسّع التلقائي بالغيغابايت. يجب أن يكون من مضاعفات 4 وأقل من أو يساوي 120* للخدمات غير المدفوعة أو 356* للخدمات المدفوعة. *- الحد الأقصى لحجم replica يخضع لتوفّر عتاد موفر السحابة في المنطقة المحددة.

النطاق المطلوب: 8 <= x <= 356يجب أن يكون من مضاعفات 4
مثال:

120

maxTotalMemoryGb
number
مهمل

مهمل - غير دقيق للخدمات التي تحتوي على أعداد غير افتراضية من replicas. الحد الأقصى لذاكرة ثلاثة workers أثناء التوسّع التلقائي بالغيغابايت. متاح فقط لخدمات 'production'. يجب أن يكون من مضاعفات 12 وأقل من أو يساوي 360 للخدمات غير المدفوعة أو 1068 للخدمات المدفوعة.

النطاق المطلوب: 24 <= x <= 1068يجب أن يكون من مضاعفات 12
مثال:

360

minReplicaMemoryGb
number

الحد الأدنى لإجمالي الذاكرة لكل replica أثناء التوسّع التلقائي بالغيغابايت. يجب أن يكون من مضاعفات 4 وأكبر من أو يساوي 8.

النطاق المطلوب: 8 <= x <= 356يجب أن يكون من مضاعفات 4
مثال:

16

minTotalMemoryGb
number
مهمل

مهمل - غير دقيق للخدمات التي تحتوي على أعداد غير افتراضية من replicas. الحد الأدنى لذاكرة ثلاثة workers أثناء التوسّع التلقائي بالغيغابايت. متاح فقط لخدمات 'production'. يجب أن يكون من مضاعفات 12 وأكبر من أو يساوي 24.

النطاق المطلوب: 24 <= x <= 1068يجب أن يكون من مضاعفات 12
مثال:

48

name
string

اسم الخدمة. سلسلة أبجدية رقمية تتضمن مسافات وبحد أقصى 50 حرفًا.

numReplicas
number

عدد replicas للخدمة. يجب أن يكون عدد replicas بين 2 و20 بالنسبة إلى أول خدمة في warehouse. يمكن أن يكون للخدمات التي تُنشأ في warehouse موجودة عدد replicas لا يقل عن 1. قد تُطبَّق قيود إضافية بحسب organization tier الخاصة بك. القيمة الافتراضية هي 1 في Basic tier و3 في Scale and Enterprise tier.

النطاق المطلوب: 1 <= x <= 20
مثال:

3

privateEndpointIds
string[]
مهمل

لربط الخدمة بـprivate endpoints، أنشئ الخدمة أولًا، ثم استخدم endpoint ‏Update Service Basic Details لتعديل private endpoints.

privatePreviewTermsChecked
boolean

اقبل الشروط والأحكام الخاصة بالمعاينة الخاصة. يلزم ذلك فقط عند إنشاء أول خدمة في المؤسسة في حالة private preview

profile
enum<string>

ملف تعريف مثيل مخصص. متاح فقط لمستويات organization من نوع ENTERPRISE.

الخيارات المتاحة:
v1-default,
v1-highmem-xs,
v1-highmem-s,
v1-highmem-m,
v1-highmem-l,
v1-highmem-xl,
v1-highcpu-s,
v1-highcpu-m,
v1-highcpu-l,
v1-highcpu-xl
provider
enum<string>

موفر السحابة

الخيارات المتاحة:
aws,
gcp,
azure
region
enum<string>

منطقة الخدمة.

الخيارات المتاحة:
ap-northeast-1,
ap-south-1,
ap-southeast-1,
ap-southeast-2,
eu-central-1,
eu-west-1,
eu-west-2,
me-central-1,
us-east-1,
us-east-2,
us-west-2,
us-east1,
us-central1,
europe-west4,
asia-southeast1,
eastus,
eastus2,
westus3,
germanywestcentral
releaseChannel
enum<string>

حدّد fast إذا كنت تريد الحصول على ClickHouse releases الجديدة بمجرد توفرها. ستحصل على New Features بسرعة أكبر، لكن مع خطر أعلى لظهور أخطاء. حدّد slow إذا كنت ترغب في تأجيل releases لمنح نفسك مزيدًا من الوقت للاختبار. هذه feature متاحة فقط لخدمات production. القيمة الافتراضية هي regular release channel.

الخيارات المتاحة:
slow,
default,
fast
tier
enum<string>
مهمل

مهمل بالنسبة إلى Basic وScale وEnterprise organization tiers. Tier الخاص بالخدمة: 'development' و'production' و'dedicated_high_mem' و'dedicated_high_cpu' و'dedicated_standard' و'dedicated_standard_n2d_standard_4' و'dedicated_standard_n2d_standard_8' و'dedicated_standard_n2d_standard_32' و'dedicated_standard_n2d_standard_128' و'dedicated_standard_n2d_standard_32_16SSD' و'dedicated_standard_n2d_standard_64_24SSD'. خدمات production قابلة للتوسّع، أما development فذات حجم ثابت. خدمات Azure لا تدعم Development tier

الخيارات المتاحة:
development,
production,
dedicated_high_mem,
dedicated_high_cpu,
dedicated_standard,
dedicated_standard_n2d_standard_4,
dedicated_standard_n2d_standard_8,
dedicated_standard_n2d_standard_32,
dedicated_standard_n2d_standard_128,
dedicated_standard_n2d_standard_32_16SSD,
dedicated_standard_n2d_standard_64_24SSD

الاستجابة

استجابة ناجحة

requestId
string<uuid>

معرّف فريد مُعيَّن لكل طلب. UUIDv4

result
object
status
number

رمز حالة HTTP.

مثال:

200

آخر تعديل في ٢ يوليو ٢٠٢٦