> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-67bc7bf8.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Обновить настройки автомасштабирования сервиса > Обновляет минимальные и максимальные лимиты памяти на реплику и поведение масштабирования в режиме бездействия для сервиса. Настройки памяти доступны только для сервисов в "продакшн" и должны быть кратны 4, начиная с 8GB. Чтобы включить возможность настройки numReplicas, необходимо обратиться в службу поддержки. ## OpenAPI ````yaml /ru/_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: >- Обновляет минимальные и максимальные лимиты памяти на реплику и поведение масштабирования в режиме бездействия для сервиса. Настройки памяти доступны только для сервисов в "продакшн" и должны быть кратны 4, начиная с 8GB. Чтобы включить возможность настройки numReplicas, необходимо обратиться в службу поддержки. parameters: - description: ID организации, которой принадлежит сервис. in: path name: organizationId required: true schema: format: uuid type: string - description: ID сервиса, для которого нужно обновить параметры масштабирования. 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 реплику. В зависимости от уровня вашей организации могут действовать дополнительные ограничения. По умолчанию используется 1 для уровня BASIC и 3 для уровней SCALE и ENTERPRISE. example: 3 maximum: 20 minimum: 1 type: number ServiceScalingPatchResponse: properties: availablePrivateEndpointIds: description: >- Список идентификаторов доступных частных конечных точек, которые можно подключить к сервису items: type: string type: array byocId: description: >- Это ID, возвращаемый после настройки региона для Собственное облако (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: Необязательная роль для шифрования диска type: string encryptionKey: description: Необязательный предоставляемый клиентом ключ шифрования диска type: string encryptionRoleId: description: >- ID роли IAM, используемой для шифрования. Доступно только если hasTransparentDataEncryption имеет значение true. type: string endpoints: description: Список всех конечных точек сервиса. items: $ref: '#/components/schemas/ServiceEndpoint' type: array hasTransparentDataEncryption: description: >- True, если для сервиса должно быть включено прозрачное шифрование данных (TDE). TDE доступно только для организаций уровня ENTERPRISE и может быть включено только при создании сервиса. type: boolean iamRole: description: роль IAM, используемая для доступа к объектам в 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: >- Максимальный объем памяти для автомасштабирования в ГБ для одной реплики. Доступно только для сервисов 'production'. Должно быть кратно 4 и меньше или равно 120 для бесплатных сервисов или 356 для платных сервисов. example: 120 maximum: 356 minimum: 8 multipleOf: 4 type: number maxTotalMemoryGb: deprecated: true description: >- УСТАРЕЛО — неточно для сервисов с количеством реплик, отличным от значения по умолчанию. Максимальный объем памяти трех воркеров при автомасштабировании в ГБ. Доступно только для сервисов 'production'. Должно быть кратно 12 и меньше или равно 360 для бесплатных сервисов или 1068 для платных сервисов. example: 360 maximum: 1068 minimum: 24 multipleOf: 12 type: number minReplicaMemoryGb: description: >- Минимальный объем памяти для автомасштабирования в ГБ для одной реплики. Доступно только для сервисов 'production'. Должно быть кратно 4 и больше или равно 8. example: 16 maximum: 356 minimum: 8 multipleOf: 4 type: number minTotalMemoryGb: deprecated: true description: >- УСТАРЕЛО — неточно для сервисов с количеством реплик, отличным от значения по умолчанию. Минимальный объем памяти трех воркеров при автомасштабировании в ГБ. Доступно только для сервисов 'production'. Должно быть кратно 12 и больше или равно 24. example: 48 maximum: 1068 minimum: 24 multipleOf: 12 type: number name: description: >- Имя сервиса. Буквенно-цифровая строка с пробелами длиной до 50 символов. type: string numReplicas: description: >- Количество реплик для сервиса. Число реплик должно быть от 2 до 20 для первого сервиса в хранилище. Сервисы, созданные в существующем хранилище, могут иметь количество реплик от 1. В зависимости от уровня вашей организации могут действовать дополнительные ограничения. По умолчанию используется 1 для уровня BASIC и 3 для уровней SCALE и ENTERPRISE. example: 3 maximum: 20 minimum: 1 type: number privateEndpointIds: description: Список частных конечных точек items: type: string type: array profile: description: >- Пользовательский профиль инстанса. Доступно только для организаций уровня 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: Регион сервиса. 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, если хотите отложить получение релизов, чтобы у вас было больше времени на тестирование. Эта возможность доступна только для сервисов в продакшн. По умолчанию используется 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: >- УСТАРЕЛО для уровней организации BASIC, SCALE и ENTERPRISE. Уровень сервиса: '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: >- ID ключа прозрачного шифрования данных, используемого для сервиса. Доступно только если hasTransparentDataEncryption имеет значение true. type: string ServiceEndpoint: properties: host: description: Имя хоста сервиса type: string port: description: Номер порта type: number protocol: description: 'Протокол конечной точки: ''https'', ''nativesecure'', ''mysql''.' enum: - https - nativesecure - mysql example: mysql type: string username: description: Необязательное имя пользователя для конечной точки nullable: true type: string IpAccessListEntry: properties: description: description: >- Необязательное описание IPv4-адреса или IPv4 CIDR, с которого разрешён доступ type: string source: description: IP или CIDR type: string securitySchemes: basicAuth: description: >- Используйте идентификатор ключа и секрет ключа, полученные в консоли ClickHouse Cloud: https://clickhouse.com/docs/cloud/manage/openapi scheme: basic type: http ````