> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Actualizar el estado del servicio > Inicia o detiene el servicio ## OpenAPI ````yaml /es/_specs/cloud-openapi.json patch /v1/organizations/{organizationId}/services/{serviceId}/state 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}/state: patch: tags: - Service summary: Actualizar el estado del servicio description: Inicia o detiene el servicio 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 cuyo estado se va a actualizar. in: path name: serviceId required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ServiceStatePatchRequest' responses: '200': content: application/json: schema: properties: requestId: description: ID único asignado a cada solicitud. UUIDv4 format: uuid type: string result: $ref: '#/components/schemas/Service' 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: ServiceStatePatchRequest: properties: command: description: 'Comando para cambiar el estado: ''start'', ''stop''.' enum: - start - stop type: string Service: properties: availablePrivateEndpointIds: description: >- Lista de los ID de endpoints privados disponibles que pueden adjuntarse al servicio items: type: string type: array byocId: description: >- Este es el ID que se devuelve después de configurar una región 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 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: Warehouse de datos que contiene este servicio type: string encryptionAssumedRoleIdentifier: description: Rol opcional que se utilizará para el cifrado de disco type: string encryptionKey: description: Clave de cifrado de disco proporcionada por el cliente, opcional type: string encryptionRoleId: description: >- El ID del rol de IAM utilizado 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 los niveles de la organización ENTERPRISE y solo puede habilitarse al crear el servicio. type: boolean iamRole: description: Rol de IAM utilizado 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 escalar hasta cero cuando está inactivo. true de forma predeterminada. type: boolean idleTimeoutMinutes: description: >- Establezca 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 warehouse 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 total máxima de cada réplica durante el autoescalado en Gb. Debe ser un múltiplo de 4 y menor o igual que 120* para servicios no de pago, o 356* para servicios de pago. * - el tamaño máximo de la réplica está sujeto a la disponibilidad de hardware del proveedor de Cloud en la región seleccionada. example: 120 maximum: 356 minimum: 8 multipleOf: 4 type: number maxTotalMemoryGb: deprecated: true description: >- DEPRECATED: inexacto para servicios con un número de réplicas distinto del predeterminado. Memoria máxima de tres workers durante el autoescalado en Gb. Disponible solo para servicios '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 total mínima de cada réplica durante el autoescalado en Gb. 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 un número de réplicas distinto del predeterminado. Memoria mínima de tres workers durante el autoescalado en Gb. Disponible solo para servicios '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 en blanco 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 crean en un warehouse existente pueden tener tan solo 1 réplica. Pueden aplicarse restricciones adicionales según el nivel de su 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. Disponible solo para los niveles de la 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: >- Seleccione fast si desea obtener nuevas versiones de ClickHouse tan pronto como estén disponibles. Obtendrá nuevas funcionalidades más rápido, pero con un mayor riesgo de errores. Seleccione slow si desea aplazar las versiones para disponer de más tiempo para realizar pruebas. Esta funcionalidad solo está disponible para servicios de producción. default 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 producción 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 utilizada 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 ````