> ## 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.

# Actualizar la configuración del escalado automático del servicio

> Actualiza los límites mínimo y máximo de memoria por réplica, así como el comportamiento del escalado en modo inactivo del servicio. La configuración de memoria está disponible solo para servicios de "producción" y debe ser un múltiplo de 4 a partir de 8 GB. Póngase en contacto con soporte para habilitar el ajuste de numReplicas.



## OpenAPI

````yaml /es/_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: Actualizar la configuración del escalado automático del servicio
      description: >-
        Actualiza los límites mínimo y máximo de memoria por réplica, así como
        el comportamiento del escalado en modo inactivo del servicio. La
        configuración de memoria está disponible solo para servicios de
        "producción" y debe ser un múltiplo de 4 a partir de 8 GB. Póngase en
        contacto con soporte para habilitar el ajuste de numReplicas.
      parameters:
        - description: ID de la organización propietaria del servicio.
          in: path
          name: organizationId
          required: true
          schema:
            format: uuid
            type: string
        - description: ID del servicio cuyos parámetros de escalado se van a actualizar.
          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: ID único asignado a cada solicitud. UUIDv4
                    format: uuid
                    type: string
                  result:
                    $ref: '#/components/schemas/ServiceScalingPatchResponse'
                  status:
                    description: Código de estado HTTP.
                    example: 200
                    type: number
                type: object
          description: Respuesta satisfactoria
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: Descripción detallada del error.
                    type: string
                  status:
                    description: Código de estado HTTP.
                    example: 400
                    type: number
                type: object
          description: >-
            El servidor no puede o no quiere procesar la solicitud debido a algo
            que se percibe como un error del client.
components:
  schemas:
    ServiceReplicaScalingPatchRequest:
      properties:
        idleScaling:
          description: >-
            Cuando se establece en true, el servicio puede escalar hasta cero
            cuando está inactivo. True de forma predeterminada.
          type: boolean
        idleTimeoutMinutes:
          description: >-
            Establece el tiempo de espera mínimo de inactividad (en minutos).
            Debe ser >= 5 minutos.
          type: number
        maxReplicaMemoryGb:
          description: >-
            Memoria máxima de escalado automático en Gb para una sola réplica.
            Disponible solo para servicios de 'production'. Debe ser un múltiplo
            de 4 y menor o igual que 120 para servicios no de pago o 356 para
            servicios de pago.
          example: 120
          maximum: 356
          minimum: 8
          multipleOf: 4
          type: number
        minReplicaMemoryGb:
          description: >-
            Memoria mínima de escalado automático en Gb para una sola réplica.
            Disponible solo para servicios de 'production'. Debe ser un múltiplo
            de 4 y mayor o igual que 8.
          example: 16
          maximum: 356
          minimum: 8
          multipleOf: 4
          type: number
        numReplicas:
          description: >-
            Número de réplicas del servicio. El número de réplicas debe estar
            entre 2 y 20 para el primer servicio de un warehouse. Los servicios
            que se crean en un warehouse existente pueden tener tan solo 1
            réplica. Pueden aplicarse restricciones adicionales según el nivel
            de tu organization. El valor predeterminado es 1 para el nivel BASIC
            y 3 para los niveles SCALE y ENTERPRISE.
          example: 3
          maximum: 20
          minimum: 1
          type: number
    ServiceScalingPatchResponse:
      properties:
        availablePrivateEndpointIds:
          description: >-
            Lista de identificadores de endpoints privados disponibles que se
            pueden adjuntar al servicio
          items:
            type: string
          type: array
        byocId:
          description: >-
            Este es el ID que se devuelve después de configurar una Region para
            Bring Your Own Cloud (BYOC). Cuando se especifica el parámetro
            byocId, también son obligatorios los parámetros minReplicaMemoryGb y
            maxReplicaGb, con valores incluidos entre los siguientes tamaños:
            48, 116, 172, 232.
          type: string
        clickhouseVersion:
          description: Versión de ClickHouse del servicio.
          type: string
        complianceType:
          description: Tipo de cumplimiento normativo del servicio.
          enum:
            - hipaa
            - pci
          type: string
        createdAt:
          description: Timestamp de creación del servicio. ISO-8601.
          format: date-time
          type: string
        dataWarehouseId:
          description: Almacén de datos que contiene este servicio
          type: string
        encryptionAssumedRoleIdentifier:
          description: Role opcional que se usará para el cifrado de disco
          type: string
        encryptionKey:
          description: Clave de cifrado de disco opcional proporcionada por el cliente
          type: string
        encryptionRoleId:
          description: >-
            El ID del IAM role usado para el cifrado. Solo está disponible si
            hasTransparentDataEncryption es true.
          type: string
        endpoints:
          description: Lista de todos los endpoints del servicio.
          items:
            $ref: '#/components/schemas/ServiceEndpoint'
          type: array
        hasTransparentDataEncryption:
          description: >-
            True si el servicio debe tener habilitado el Cifrado transparente de
            datos (TDE). TDE solo está disponible para niveles de organización
            ENTERPRISE y solo puede habilitarse al crear el servicio.
          type: boolean
        iamRole:
          description: IAM role usado para acceder a objetos en S3
          type: string
        id:
          description: ID único del servicio.
          format: uuid
          type: string
        idleScaling:
          description: >-
            Cuando se establece en true, el servicio puede reducir su escala a
            cero cuando está inactivo. True de forma predeterminada.
          type: boolean
        idleTimeoutMinutes:
          description: >-
            Establece el timeout mínimo de inactividad (en minutos). Debe ser >=
            5 minutos.
          type: number
        ipAccessList:
          description: Lista de direcciones IP autorizadas para acceder al servicio
          items:
            $ref: '#/components/schemas/IpAccessListEntry'
          type: array
        isPrimary:
          description: True si este servicio es el servicio principal del almacén de datos
          type: boolean
        isReadonly:
          description: >-
            True si este servicio es de solo lectura. Solo puede ser de solo
            lectura si se proporciona un dataWarehouseId.
          type: boolean
        maxReplicaMemoryGb:
          description: >-
            Memoria máxima de autoescalado en Gb para una sola réplica.
            Disponible solo para servicios de 'production'. Debe ser un múltiplo
            de 4 y menor o igual que 120 para servicios no de pago, o 356 para
            servicios de pago.
          example: 120
          maximum: 356
          minimum: 8
          multipleOf: 4
          type: number
        maxTotalMemoryGb:
          deprecated: true
          description: >-
            DEPRECATED - inexacto para servicios con una cantidad de réplicas
            distinta de la predeterminada. Memoria máxima de tres workers
            durante el autoescalado, en Gb. Disponible solo para servicios de
            'production'. Debe ser un múltiplo de 12 y menor o igual que 360
            para servicios no de pago, o 1068 para servicios de pago.
          example: 360
          maximum: 1068
          minimum: 24
          multipleOf: 12
          type: number
        minReplicaMemoryGb:
          description: >-
            Memoria mínima de autoescalado en Gb para una sola réplica.
            Disponible solo para servicios de 'production'. Debe ser un múltiplo
            de 4 y mayor o igual que 8.
          example: 16
          maximum: 356
          minimum: 8
          multipleOf: 4
          type: number
        minTotalMemoryGb:
          deprecated: true
          description: >-
            DEPRECATED - inexacto para servicios con una cantidad de réplicas
            distinta de la predeterminada. Memoria mínima de tres workers
            durante el autoescalado, en Gb. Disponible solo para servicios de
            'production'. Debe ser un múltiplo de 12 y mayor o igual que 24.
          example: 48
          maximum: 1068
          minimum: 24
          multipleOf: 12
          type: number
        name:
          description: >-
            Nombre del servicio. Cadena alfanumérica con espacios de hasta 50
            caracteres.
          type: string
        numReplicas:
          description: >-
            Número de réplicas del servicio. El número de réplicas debe estar
            entre 2 y 20 para el primer servicio de un warehouse. Los servicios
            que se creen en un warehouse existente pueden tener tan solo 1
            réplica. Pueden aplicarse restricciones adicionales según el nivel
            de la organización. El valor predeterminado es 1 para el nivel BASIC
            y 3 para los niveles SCALE y ENTERPRISE.
          example: 3
          maximum: 20
          minimum: 1
          type: number
        privateEndpointIds:
          description: Lista de endpoints privados
          items:
            type: string
          type: array
        profile:
          description: >-
            Perfil de instancia personalizado. Solo disponible para niveles de
            organización 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: Proveedor de Cloud
          enum:
            - aws
            - gcp
            - azure
          type: string
        region:
          description: Región del servicio.
          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: >-
            Selecciona fast si quieres obtener las nuevas versiones de
            ClickHouse en cuanto estén disponibles. Recibirás nuevas
            funcionalidades más rápido, pero con un mayor riesgo de errores.
            Selecciona slow si deseas aplazar las versiones para tener más
            tiempo para probarlas. Esta funcionalidad solo está disponible para
            servicios de production. El valor predeterminado es el canal de
            versiones regular.
          enum:
            - slow
            - default
            - fast
          type: string
        state:
          description: Estado actual del servicio.
          enum:
            - starting
            - stopping
            - terminating
            - awaking
            - partially_running
            - provisioning
            - running
            - stopped
            - terminated
            - degraded
            - failed
            - idle
          type: string
        tier:
          deprecated: true
          description: >-
            DEPRECATED para los niveles de la organización BASIC, SCALE y
            ENTERPRISE. Nivel del servicio: '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'. Los servicios de
            Production escalan; los de Development tienen un tamaño fijo. Los
            servicios de Azure no admiten el nivel 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: >-
            El ID de la clave de Cifrado transparente de datos usada para el
            servicio. Solo está disponible si hasTransparentDataEncryption es
            true.
          type: string
    ServiceEndpoint:
      properties:
        host:
          description: Nombre del host del servicio
          type: string
        port:
          description: Puerto numérico
          type: number
        protocol:
          description: 'Protocolo del endpoint: ''https'', ''nativesecure'', ''mysql''.'
          enum:
            - https
            - nativesecure
            - mysql
          example: mysql
          type: string
        username:
          description: Nombre de usuario opcional para el endpoint
          nullable: true
          type: string
    IpAccessListEntry:
      properties:
        description:
          description: >-
            Descripción opcional de la dirección IPv4 o del CIDR IPv4 desde los
            que se permitirá el acceso
          type: string
        source:
          description: IP o CIDR
          type: string
  securitySchemes:
    basicAuth:
      description: >-
        Usa el ID de la clave y el secreto de la clave obtenidos en la consola
        de ClickHouse Cloud: https://clickhouse.com/docs/cloud/manage/openapi
      scheme: basic
      type: http

````