> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-55d9d317.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # تحديث إعدادات التوسع التلقائي للخدمة > يحدّث حدود الذاكرة الدنيا والعليا لكل replica وسلوك التوسّع في وضع الخمول للخدمة. لا تتوفر إعدادات الذاكرة إلا لخدمات "production"، ويجب أن تكون من مضاعفات 4 بدءًا من 8GB. يُرجى التواصل مع الدعم لتمكين تعديل numReplicas. ## OpenAPI ````yaml /ar/_specs/cloud-openapi.json patch /v1/organizations/{organizationId}/services/{serviceId}/replicaScaling openapi: 3.0.1 info: contact: email: support@clickhouse.com name: ClickHouse Support url: >- https://clickhouse.com/docs/en/cloud/manage/openapi?referrer=openapi-299828 title: OpenAPI spec for ClickHouse Cloud version: '1.0' servers: - url: https://api.clickhouse.cloud security: - basicAuth: [] tags: - name: Organization - name: User management - name: Billing - name: Service - name: Backup - name: OpenAPI - name: Prometheus - name: ClickPipes paths: /v1/organizations/{organizationId}/services/{serviceId}/replicaScaling: patch: tags: - Service summary: تحديث إعدادات التوسع التلقائي للخدمة description: >- يحدّث حدود الذاكرة الدنيا والعليا لكل replica وسلوك التوسّع في وضع الخمول للخدمة. لا تتوفر إعدادات الذاكرة إلا لخدمات "production"، ويجب أن تكون من مضاعفات 4 بدءًا من 8GB. يُرجى التواصل مع الدعم لتمكين تعديل numReplicas. parameters: - description: معرّف المؤسسة المالكة للخدمة. in: path name: organizationId required: true schema: format: uuid type: string - description: معرّف الخدمة المطلوب تحديث معلمات التوسّع الخاصة بها. in: path name: serviceId required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ServiceReplicaScalingPatchRequest' responses: '200': content: application/json: schema: properties: requestId: description: معرّف فريد يُخصَّص لكل طلب. UUIDv4 format: uuid type: string result: $ref: '#/components/schemas/ServiceScalingPatchResponse' status: description: رمز حالة HTTP. example: 200 type: number type: object description: استجابة ناجحة '400': content: application/json: schema: properties: error: description: وصف مفصل للخطأ. type: string status: description: رمز حالة HTTP. example: 400 type: number type: object description: >- يتعذر على الخادم معالجة الطلب أو يرفض معالجته بسبب أمر يُعتبر خطأً من جهة العميل. components: schemas: ServiceReplicaScalingPatchRequest: properties: idleScaling: description: >- عند ضبطها على true، يُسمح للخدمة بخفض التوسّع إلى الصفر عند الخمول. والقيمة الافتراضية هي True. type: boolean idleTimeoutMinutes: description: عيّن الحد الأدنى لمهلة الخمول (بالدقائق). يجب أن تكون >= 5 دقائق. type: number maxReplicaMemoryGb: description: >- الحد الأقصى لذاكرة التوسّع التلقائي، بالغيغابايت، لنسخة متماثلة واحدة. متاح فقط لخدمات 'production'. يجب أن يكون من مضاعفات 4 وأقل من أو يساوي 120 للخدمات غير المدفوعة أو 356 للخدمات المدفوعة. example: 120 maximum: 356 minimum: 8 multipleOf: 4 type: number minReplicaMemoryGb: description: >- الحد الأدنى لذاكرة التوسّع التلقائي، بالغيغابايت، لنسخة متماثلة واحدة. متاح فقط لخدمات 'production'. يجب أن يكون من مضاعفات 4 وأكبر من أو يساوي 8. example: 16 maximum: 356 minimum: 8 multipleOf: 4 type: number numReplicas: description: >- عدد النسخ المتماثلة للخدمة. يجب أن يكون عدد النسخ المتماثلة بين 2 و20 بالنسبة إلى الخدمة الأولى في مستودع البيانات. ويمكن أن يكون للخدمات التي يتم إنشاؤها في مستودع بيانات موجود عدد نسخ متماثلة يبدأ من 1. وقد تنطبق قيود إضافية بحسب مستوى organization لديك. وتكون القيمة الافتراضية 1 لـ BASIC tier و3 لـ Scale and Enterprise tier. example: 3 maximum: 20 minimum: 1 type: number ServiceScalingPatchResponse: properties: availablePrivateEndpointIds: description: قائمة بمعرّفات نقاط النهاية الخاصة المتاحة التي يمكن إرفاقها بالخدمة items: type: string type: array byocId: description: >- هذا هو المعرّف الذي يتم إرجاعه بعد إعداد Region لـ Bring Your Own Cloud (BYOC). عند تحديد المعامل byocId، يصبح المعاملان minReplicaMemoryGb و maxReplicaGb مطلوبين أيضًا، على أن تكون قيمهما من بين الأحجام التالية: 48، 116، 172، 232. type: string clickhouseVersion: description: إصدار ClickHouse الخاص بالخدمة. type: string complianceType: description: نوع الامتثال التنظيمي للخدمة. enum: - hipaa - pci type: string createdAt: description: الطابع الزمني لإنشاء الخدمة. ISO-8601. format: date-time type: string dataWarehouseId: description: مستودع البيانات الذي تتبعه هذه الخدمة type: string encryptionAssumedRoleIdentifier: description: Role اختياري لاستخدامه في تشفير القرص type: string encryptionKey: description: مفتاح اختياري يوفّره العميل لتشفير القرص type: string encryptionRoleId: description: >- معرّف IAM role المستخدم للتشفير. وهذا متاح فقط إذا كانت hasTransparentDataEncryption تساوي true. type: string endpoints: description: قائمة جميع endpoints الخدمة. items: $ref: '#/components/schemas/ServiceEndpoint' type: array hasTransparentDataEncryption: description: >- تكون القيمة True إذا كان يجب تمكين Transparent Data Encryption (TDE) لهذه الخدمة. يتوفر TDE فقط لمستويات organization من نوع ENTERPRISE، ولا يمكن تمكينه إلا عند إنشاء الخدمة. type: boolean iamRole: description: IAM role المستخدم للوصول إلى objects في S3 type: string id: description: معرّف الخدمة الفريد. format: uuid type: string idleScaling: description: >- عند ضبطها على true، يُسمح للخدمة بالتوسّع نزولًا إلى الصفر عند الخمول. true افتراضيًا. type: boolean idleTimeoutMinutes: description: اضبط الحد الأدنى لمهلة الخمول (بالدقائق). يجب أن تكون >= 5 دقائق. type: number ipAccessList: description: قائمة عناوين IP المسموح لها بالوصول إلى الخدمة items: $ref: '#/components/schemas/IpAccessListEntry' type: array isPrimary: description: >- تكون القيمة True إذا كانت هذه الخدمة هي الخدمة الأساسية في مستودع البيانات type: boolean isReadonly: description: >- تكون القيمة True إذا كانت هذه الخدمة للقراءة فقط. ولا يمكن أن تكون للقراءة فقط إلا إذا تم توفير dataWarehouseId. type: boolean maxReplicaMemoryGb: description: >- الحد الأقصى لذاكرة التوسّع التلقائي بالغيغابايت لنسخة replica واحدة. متاح فقط لخدمات 'production'. يجب أن يكون من مضاعفات 4 وأقل من أو يساوي 120 للخدمات غير المدفوعة أو 356 للخدمات المدفوعة. example: 120 maximum: 356 minimum: 8 multipleOf: 4 type: number maxTotalMemoryGb: deprecated: true description: >- مهمل - غير دقيق للخدمات التي تحتوي على أعداد replicas غير افتراضية. الحد الأقصى للذاكرة لثلاثة workers أثناء التوسّع التلقائي، بالغيغابايت. متاح فقط لخدمات 'production'. يجب أن يكون من مضاعفات 12 وأقل من أو يساوي 360 للخدمات غير المدفوعة أو 1068 للخدمات المدفوعة. example: 360 maximum: 1068 minimum: 24 multipleOf: 12 type: number minReplicaMemoryGb: description: >- الحد الأدنى لذاكرة التوسّع التلقائي بالغيغابايت لنسخة replica واحدة. متاح فقط لخدمات 'production'. يجب أن يكون من مضاعفات 4 وأن يكون أكبر من أو يساوي 8. example: 16 maximum: 356 minimum: 8 multipleOf: 4 type: number minTotalMemoryGb: deprecated: true description: >- مهمل - غير دقيق للخدمات التي تحتوي على أعداد replicas غير افتراضية. الحد الأدنى للذاكرة لثلاثة workers أثناء التوسّع التلقائي، بالغيغابايت. متاح فقط لخدمات 'production'. يجب أن يكون من مضاعفات 12 وأن يكون أكبر من أو يساوي 24. example: 48 maximum: 1068 minimum: 24 multipleOf: 12 type: number name: description: اسم الخدمة. سلسلة أبجدية رقمية تتضمن مسافات، بحد أقصى 50 حرفًا. type: string numReplicas: description: >- عدد replicas للخدمة. يجب أن يكون عدد replicas بين 2 و20 لأول خدمة في warehouse. يمكن أن يكون عدد replicas للخدمات التي يتم إنشاؤها في warehouse موجود منخفضًا حتى 1. قد تنطبق قيود إضافية بحسب tier الخاصة بـ organization لديك. القيمة الافتراضية هي 1 لمستوى BASIC و3 لمستويي SCALE وENTERPRISE. example: 3 maximum: 20 minimum: 1 type: number privateEndpointIds: description: قائمة نقاط النهاية الخاصة items: type: string type: array profile: description: >- ملف تعريف مخصص للمثيل. متاح فقط لمستويات organization من نوع ENTERPRISE. enum: - 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 type: string provider: description: موفر السحابة enum: - aws - gcp - azure type: string region: description: Region الخاصة بالخدمة. enum: - 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 type: string releaseChannel: description: >- حدّد fast إذا كنت تريد الحصول على إصدارات ClickHouse الجديدة بمجرد توفرها. ستحصل على الميزات الجديدة بشكل أسرع، ولكن مع احتمال أعلى لظهور أخطاء برمجية. وحدّد slow إذا كنت ترغب في تأجيل الإصدارات لمنح نفسك مزيدًا من الوقت للاختبار. هذه الميزة متاحة فقط لخدمات production. والقيمة الافتراضية هي regular release channel. enum: - slow - default - fast type: string state: description: الحالة الحالية للخدمة. enum: - starting - stopping - terminating - awaking - partially_running - provisioning - running - stopped - terminated - degraded - failed - idle type: string tier: deprecated: true description: >- مهمل لمستويات organization من نوع BASIC وSCALE وENTERPRISE. 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 enum: - 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 type: string transparentDataEncryptionKeyId: description: >- معرّف المفتاح الخاص بـ Transparent Data Encryption المستخدم لهذه الخدمة. وهذا متاح فقط إذا كانت hasTransparentDataEncryption تساوي true. type: string ServiceEndpoint: properties: host: description: اسم مضيف الخدمة type: string port: description: رقم المنفذ type: number protocol: description: 'بروتوكول endpoint: ''https''، ''nativesecure''، ''mysql''.' enum: - https - nativesecure - mysql example: mysql type: string username: description: اسم مستخدم اختياري لـ endpoint nullable: true type: string IpAccessListEntry: properties: description: description: وصف اختياري لعنوان IPv4 أو IPv4 CIDR المسموح بالوصول منه type: string source: description: IP أو CIDR type: string securitySchemes: basicAuth: description: >- استخدم معرّف المفتاح والسرّ الخاص به اللذين تم الحصول عليهما من ClickHouse Cloud console: https://clickhouse.com/docs/cloud/manage/openapi scheme: basic type: http ````