> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Crear un nuevo servicio > Crea un nuevo servicio en la organización y devuelve el estado actual del servicio y una contraseña para acceder a él. El servicio se inicia de forma asíncrona. ## OpenAPI ````yaml /es/_specs/cloud-openapi.json post /v1/organizations/{organizationId}/services 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: post: tags: - Service summary: Crear un nuevo servicio description: >- Crea un nuevo servicio en la organización y devuelve el estado actual del servicio y una contraseña para acceder a él. El servicio se inicia de forma asíncrona. parameters: - description: ID de la organización que será propietaria del servicio. in: path name: organizationId required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ServicePostRequest' responses: '200': content: application/json: schema: properties: requestId: description: ID único asignado a cada solicitud. UUIDv4 format: uuid type: string result: $ref: '#/components/schemas/ServicePostResponse' 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 server no puede o no quiere procesar la solicitud debido a algo que se percibe como un error del client. components: schemas: ServicePostRequest: properties: backupId: description: >- ID de Backup opcional que se usa como estado inicial del nuevo servicio. Cuando se usa, la región y el nivel de la nueva instancia deben ser los mismos que los de la instancia original. format: uuid type: string 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 complianceType: description: Tipo de cumplimiento normativo del servicio. enum: - hipaa - pci type: string dataWarehouseId: description: Warehouse 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 endpoints: description: Lista de endpoints del servicio para habilitar o deshabilitar items: $ref: '#/components/schemas/ServiceEndpointChange' 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 idleScaling: description: >- Cuando se establece en true, el servicio puede escalar hasta cero cuando está idle. True de forma predeterminada. type: boolean idleTimeoutMinutes: description: >- Establezca el timeout mínimo de idling (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 isReadonly: description: >- True si este servicio es read-only. Solo puede ser read-only 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 pagos o 356* para servicios pagos.* - 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: no es preciso para servicios con una cantidad no predeterminada de réplicas. 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 pagos o 1068 para servicios pagos. 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: no es preciso para servicios con una cantidad no predeterminada de réplicas. 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 de hasta 50 caracteres. type: string numReplicas: description: >- Número de réplicas del servicio. La cantidad 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 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: deprecated: true description: >- Para asociar el servicio con private endpoints, primero cree el servicio y luego use el endpoint `Update Service Basic Details` para modificar los private endpoints. items: type: string type: array privatePreviewTermsChecked: description: >- Acepte los terms y conditions de private preview. Solo es necesario al crear el primer servicio de la organización en caso de private preview type: boolean profile: description: >- Perfil de instancia personalizado. Solo disponible 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 las nuevas versiones de ClickHouse en cuanto estén disponibles. Obtendrá Nuevas características más rápido, pero con un mayor riesgo de errores. Seleccione slow si desea aplazar las versiones para tener más tiempo para probarlas. Esta característica solo está disponible para servicios de production. El valor predeterminado es el regular release channel. enum: - slow - default - fast 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 Production escalan; los 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 ServicePostResponse: properties: password: description: Contraseña del servicio recién creado. type: string service: $ref: '#/components/schemas/Service' ServiceEndpointChange: properties: enabled: description: Habilitar o deshabilitar el endpoint type: boolean protocol: description: Protocolo del endpoint enum: - mysql example: mysql 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 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 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 ````